Nullable ジェネリック構造体

.NET Framework クラス ライブラリ リファレンス

Nullable ジェネリック構造体

メモ : この構造体は、.NET Framework version 2.0 で新しく追加されたものです。

基になる型が値型のオブジェクトを表します。参照型のように null 参照 (Visual Basic では Nothing) も割り当てることができます。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Structure Nullable(Of
 T As Structure)

Visual Basic (使用法)

Dim instance As Nullable(Of
 T)

C#

[SerializableAttribute] 
public struct Nullable<T> where T : struct

C++

[SerializableAttribute] 
generic<typename T> where T : ValueType
public value class Nullable

J#

J# では、ジェネリックな型およびメソッドは使用できますが、新規に宣言することはできません。

JScript

JScript では、ジェネリックな型およびメソッドは使用できません。

解説

型に値または null 参照 (Visual Basic では Nothing) を割り当てることができる場合、その型を NULL 許容型と呼びます。null は、型に値がないことを表します。そのため、NULL 許容型では、値を表すことも、値がないことを表すこともできます。たとえば、String のような参照型は、NULL 許容型です。Int32 のような値型は、NULL 許容型ではありません。値型は、その型に適した値を表すだけの容量しかなく、null 値を表すための追加の容量がないので、NULL 許容型ではありません。

設計上、参照型は NULL 許容型なので、Nullable 構造体は、NULL 許容型としての値型の使用のみをサポートします。

Nullable クラスは、Nullable 構造体への補完的なサポートを提供します。Nullable クラスは、NULL 許容型の基になる型の取得、および基になる値型がジェネリック型の比較演算と等値演算をサポートしない NULL 許容型のペアに対する比較演算と等値演算をサポートします。

シナリオ

状況によって値の有無が決定される場合、この値を表すために NULL 許容型を使用します。たとえば、HTML タグのオプションの属性が特定のタグに存在し、別のタグには存在しない場合や、データベース テーブルの null 許容列が同じテーブル内の特定の行に存在し、別の行には存在しない場合などです。

属性または列をクラス内のフィールドとして表し、そのフィールドを値型として定義できます。このフィールドには、属性または列を表すすべての有効な値を格納できますが、属性または列が存在しないことを表す追加の値を格納できません。この場合は、フィールドを値型ではなく、NULL 許容型として定義します。

基本的なプロパティ

Nullable 構造体の 2 つの基本的なメンバは、HasValue プロパティと Value プロパティです。Nullable オブジェクトの HasValue プロパティが true の場合、オブジェクトの値にアクセスするには、Value プロパティを使用します。HasValue プロパティが false で、オブジェクトの値が定義されていない場合に、Value プロパティにアクセスしようとすると、InvalidOperationException がスローされます。

ボックス化とボックス化解除

NULL 許容型がボックス化されると、共通言語ランタイムは、Nullable オブジェクト自体ではなく、Nullable オブジェクトの基になる値を自動的にボックス化します。つまり、HasValue プロパティが true である場合、Value プロパティの内容がボックス化されます。HasValue プロパティが false の場合は、null 参照 (Visual Basic では Nothing) が返されます。NULL 許容型の基になる値がボックス化解除されると、共通言語ランタイムは、基になる値に対して初期化された新しい Nullable 構造体を作成します。

使用例

Microsoft Pubs サンプル データベースのテーブル内の 3 つの行を定義するコード例を次に示します。このテーブルには、null 非許容列が 2 列と null 許容列が 2 列含まれます。

Visual Basic

' This code example demonstrates the Nullable(Of T) class.
' The code example defines a database table in which two columns 
' are nullable. In the application, an array of rows is created 
' and initialized. The table rows could subsequently be 
' written to a database.

Imports System

Class Sample
    ' Define the "titleAuthor" table of the Microsoft "pubs"
 database. 
    
    Public Structure titleAuthor
    ' Author ID; format ###-##-####
        Public au_id As String
    ' Title ID; format AA####
        Public title_id As String
    ' Author ORD is nullable.
        Public au_ord As Nullable(Of
 Short)
    ' Royalty Percent is nullable.
        Public royaltyper As Nullable(Of
 Integer)
    End Structure 'titleAuthor
    
    Public Shared Sub Main()
 
    ' Declare and initialize the titleAuthor array.
        Dim ta(2) As titleAuthor
        ta(0).au_id = "712-32-1176"
        ta(0).title_id = "PS3333"
        ta(0).au_ord = 1
        ta(0).royaltyper = 100
        
        ta(1).au_id = "213-46-8915"
        ta(1).title_id = "BU1032"
        ta(1).au_ord = Nothing
        ta(1).royaltyper = Nothing
        
        ta(2).au_id = "672-71-3249"
        ta(2).title_id = "TC7777"
        ta(2).au_ord = Nothing
        ta(2).royaltyper = 40
        
    ' Display the values of the titleAuthor array elements, and 
    ' display a legend.
        Display("Title Authors Table", ta)
        Console.WriteLine("Legend:")
        Console.WriteLine("An Author ORD of -1 means no value
 is defined.")
        Console.WriteLine("A Royalty % of 0 means no value is
 defined.")
    End Sub 'Main
    
    ' Display the values of the titleAuthor array elements.
    Public Shared Sub Display(ByVal
 dspTitle As String, _
                              ByVal dspAllTitleAuthors() As
 titleAuthor) 
        Console.WriteLine("*** {0} ***", dspTitle)
        Dim dspTA As titleAuthor
        For Each dspTA In
 dspAllTitleAuthors
            Console.WriteLine("Author ID ... {0}",
 dspTA.au_id)
            Console.WriteLine("Title ID .... {0}",
 dspTA.title_id)
            Console.WriteLine("Author ORD .. {0}",
 dspTA.au_ord.GetValueOrDefault(-1))
            Console.WriteLine("Royalty % ... {0}",
 dspTA.royaltyper.GetValueOrDefault(0))
            Console.WriteLine()
        Next dspTA
    End Sub 'Display
End Class 'Sample

'
'This code example produces the following results:
'
'*** Title Authors Table ***
'Author ID ... 712-32-1176
'Title ID .... PS3333
'Author ORD .. 1
'Royalty % ... 100
'
'Author ID ... 213-46-8915
'Title ID .... BU1032
'Author ORD .. -1
'Royalty % ... 0
'
'Author ID ... 672-71-3249
'Title ID .... TC7777
'Author ORD .. -1
'Royalty % ... 40
'
'Legend:
'An Author ORD of -1 means no value is defined.
'A Royalty % of 0 means no value is defined.
'

C#

// This code example demonstrates the Nullable<T> class.
// The code example defines a database table in which two columns 
// are nullable. In the application, an array of rows is created 
// and initialized. The table rows could subsequently be 
// written to a database.

using System;

class Sample 
{
// Define the "titleAuthor" table of the Microsoft "pubs"
 database. 
    public struct titleAuthor 
    {
    // Author ID; format ###-##-####
    public string au_id;
    // Title ID; format AA####
    public string title_id;
    // Author ORD is nullable.
    public short? au_ord;
    // Royalty Percent is nullable.
    public int? royaltyper;
    }

    public static void Main()
 
    {
// Declare and initialize the titleAuthor array.
    titleAuthor[] ta = new titleAuthor[3];
    ta[0].au_id = "712-32-1176";
    ta[0].title_id = "PS3333";
    ta[0].au_ord = 1;
    ta[0].royaltyper = 100;
  
    ta[1].au_id = "213-46-8915";
    ta[1].title_id = "BU1032";
    ta[1].au_ord = null;
    ta[1].royaltyper = null;

    ta[2].au_id = "672-71-3249";
    ta[2].title_id = "TC7777";
    ta[2].au_ord = null;
    ta[2].royaltyper = 40;

// Display the values of the titleAuthor array elements, and 
// display a legend.
    Display("Title Authors Table", ta);
    Console.WriteLine("Legend:");
    Console.WriteLine("An Author ORD of -1 means no value is defined.");
    Console.WriteLine("A Royalty % of 0 means no value is defined.");
    }

// Display the values of the titleAuthor array elements.
    public static void Display(string
 dspTitle, 
                               titleAuthor[] dspAllTitleAuthors)
    {
    Console.WriteLine("*** {0} ***", dspTitle);
    foreach (titleAuthor dspTA in dspAllTitleAuthors)
       {
       Console.WriteLine("Author ID ... {0}", dspTA.au_id);
       Console.WriteLine("Title ID .... {0}", dspTA.title_id);
       Console.WriteLine("Author ORD .. {0}", dspTA.au_ord ?? -1);
       Console.WriteLine("Royalty % ... {0}", dspTA.royaltyper ?? 0);
       Console.WriteLine();       
       }
    }
}

/*
This code example produces the following results:

*** Title Authors Table ***
Author ID ... 712-32-1176
Title ID .... PS3333
Author ORD .. 1
Royalty % ... 100

Author ID ... 213-46-8915
Title ID .... BU1032
Author ORD .. -1
Royalty % ... 0

Author ID ... 672-71-3249
Title ID .... TC7777
Author ORD .. -1
Royalty % ... 40

Legend:
An Author ORD of -1 means no value is defined.
A Royalty % of 0 means no value is defined.

*/

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Nullable メンバ
System 名前空間
Nullable クラス