INullable.IsNull プロパティ

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

INullable.IsNull プロパティ

構造体が null かどうかを示します。このプロパティは読み取り専用です。

名前空間: System.Data.SqlTypes
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

ReadOnly Property IsNull As
 Boolean

Visual Basic (使用法)

Dim instance As INullable
Dim value As Boolean

value = instance.IsNull

C#

bool IsNull { get; }

C++

property bool IsNull {
    bool get ();
}

J#

/** @property */
boolean get_IsNull ()

JScript

function get IsNull () : boolean

プロパティ値
SqlBoolean このオブジェクトの値が null の場合は true。それ以外の場合は false。

解説

System.Data.SqlTypes のすべてのインスタンスは、既定値が null になります。null 値であるかどうかをテストするには、IsNull プロパティを使用します。

使用例

SqlInt32 および SqlString として定義された 2 つの列を持つ DataTable を作成するコード例を次に示します。このコードでは、既知の値を保持する行と、null 値を保持する行をそれぞれ 1 つずつ追加しています。その後、DataTable を反復処理しながら変数に値を代入し、結果をコンソール ウィンドウに表示します。

Visual Basic

Private Sub WorkWithSqlNulls()
    Dim table As New DataTable()

    ' Specify the SqlType for each column.
    Dim idColumn As DataColumn = _
      table.Columns.Add("ID", GetType(SqlInt32))
    Dim descColumn As DataColumn = _
      table.Columns.Add("Description", GetType(SqlString))

    ' Add some data.
    Dim row As DataRow = table.NewRow()
    row("ID") = 123
    row("Description") = "Side
 Mirror"
    table.Rows.Add(row)

    ' Add null values.
    row = table.NewRow()
    row("ID") = SqlInt32.Null
    row("Description") = SqlString.Null
    table.Rows.Add(row)

    ' Initialize variables to use when
    ' extracting the data.
    Dim isColumnNull As SqlBoolean = False
    Dim idValue As SqlInt32 = SqlInt32.Zero
    Dim descriptionValue As SqlString = SqlString.Null

    ' Iterate through the DataTable and display the values.
    For Each row In table.Rows
        ' Assign values to variables. Note that you 
        ' do not have to test for null values.
        idValue = CType(row("ID"), SqlInt32)
        descriptionValue = CType(row("Description"),
 SqlString)

        ' Test for null value with ID column
        isColumnNull = idValue.IsNull

        ' Display variable values in console window.
        Console.Write("isColumnNull={0}, ID={1}, Description={2}",
 _
          isColumnNull, idValue, descriptionValue)
        Console.WriteLine()
    Next row
End Sub

C#

static private void WorkWithSqlNulls()
{
    DataTable table = new DataTable();

    // Specify the SqlType for each column.
    DataColumn idColumn =
        table.Columns.Add("ID", typeof(SqlInt32));
    DataColumn descColumn =
        table.Columns.Add("Description", typeof(SqlString));

    // Add some data.
    DataRow nRow = table.NewRow();
    nRow["ID"] = 123;
    nRow["Description"] = "Side Mirror";
    table.Rows.Add(nRow);

    // Add null values.
    nRow = table.NewRow();
    nRow["ID"] = SqlInt32.Null;
    nRow["Description"] = SqlString.Null;
    table.Rows.Add(nRow);

    // Initialize variables to use when
    // extracting the data.
    SqlBoolean isColumnNull = false;
    SqlInt32 idValue = SqlInt32.Zero;
    SqlString descriptionValue = SqlString.Null;

    // Iterate through the DataTable and display the values.
    foreach (DataRow row in table.Rows)
    {
        // Assign values to variables. Note that you 
        // do not have to test for null values.
        idValue = (SqlInt32)row["ID"];
        descriptionValue = (SqlString)row["Description"];

        // Test for null value in ID column.
        isColumnNull = idValue.IsNull;

        // Display variable values in console window.
        Console.Write("isColumnNull={0}, ID={1}, Description={2}",
            isColumnNull, idValue, descriptionValue);
        Console.WriteLine();
    }

この例では、次の結果が生成されます。

isColumnNull=False, ID=123, Description=Side Mirror
isColumnNull=True, ID=Null, Description=Null

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
INullable インターフェイス
INullable メンバ
System.Data.SqlTypes 名前空間
その他の技術情報
NULL 値の処理
SqlTypes の使用