DataTableReader.IsDBNull(Int32) DataTableReader.IsDBNull(Int32) DataTableReader.IsDBNull(Int32) DataTableReader.IsDBNull(Int32) Method

定義

列に格納されている値が存在しない値または欠損値かどうかを示す値を取得します。Gets a value that indicates whether the column contains non-existent or missing values.

public:
 override bool IsDBNull(int ordinal);
public override bool IsDBNull (int ordinal);
override this.IsDBNull : int -> bool
Public Overrides Function IsDBNull (ordinal As Integer) As Boolean

パラメーター

ordinal
Int32 Int32 Int32 Int32

列の 0 から始まる序数。The zero-based column ordinal

戻り値

指定した列の値が DBNull と等価である場合は true。それ以外の場合は falsetrue if the specified column value is equivalent to DBNull; otherwise, false.

例外

渡されたインデックスが 0 から FieldCount - 1 の範囲にありません。The index passed was outside the range of 0 to FieldCount - 1.

削除した行からデータを取得しようとしました。An attempt was made to retrieve data from a deleted row.

閉じている DataTableReader の列を読み取るかアクセスしようとしました。An attempt was made to read or access a column in a closed DataTableReader .

次の例では、渡さDataTableReaderれた内の列番号2の内容を表示します。The following example displays the contents of the column numbered 2 within the passed-in DataTableReader. 値が特定の行の列が null の場合、コードには null > <というテキストが表示されます。If the value the column within a particular row is null, the code displays the text <NULL>. 正しい型の列内のデータの場合、この例では各行のエラーメッセージが表示されます。If the data within the column of the correct type, the example displays an error message for each row.

private static void PrintColumn(DataTableReader reader)
{
    // Loop through all the rows in the DataTableReader
    while (reader.Read())
    {
        if (reader.IsDBNull(2))
        {
            Console.Write("<NULL>");
        }
        else
        {
            try
            {
                Console.Write(reader.GetString(2));
            }
            catch (InvalidCastException)
            {
                Console.Write("Invalid data type.");
            }
        }
        Console.WriteLine();
    }
}
Private Sub PrintColumn(ByVal reader As DataTableReader)
   ' Loop through all the rows in the DataTableReader
   While reader.Read()
      If reader.IsDBNull(2) Then
         Console.Write("<NULL>")
      Else
         Try
            Console.Write(reader.GetString(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

注釈

このメソッドを呼び出して、型指定された get メソッド ( GetByte GetChar、など) を呼び出す前に null 列の値があるかどうかを確認し、エラーが発生しないようにします。Call this method to see if there are null column values before calling the typed get methods (for example, GetByte, GetChar, and so on) to avoid raising an error.

適用対象