DataRow.IsNull 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

取得值，指出指定的資料行是否包含 Null 值。

多載

IsNull(DataColumn)	取得值，指出指定的 DataColumn 是否含有 Null 值。
IsNull(Int32)	取得值，指出指定之索引處的資料行是否包含 Null 值。
IsNull(String)	取得值，指出具名資料行是否包含 Null 值。
IsNull(DataColumn, DataRowVersion)	取得值，指出指定的 DataColumn 和 DataRowVersion 是否包含 Null 值。

IsNull(DataColumn)

來源:

DataRow.cs

取得值，指出指定的 DataColumn 是否含有 Null 值。

public:
 bool IsNull(System::Data::DataColumn ^ column);

public bool IsNull (System.Data.DataColumn column);

member this.IsNull : System.Data.DataColumn -> bool

Public Function IsNull (column As DataColumn) As Boolean

參數

column

DataColumn

DataColumn。

傳回

Boolean

如果資料行包含 Null 值，則為 true，否則為 false。

例外狀況

ArgumentNullException

column 為 null。

RowNotInTableException

資料列不屬於資料表。

範例

下列範例會列印 的每個數據表 DataSet中每個數據列的每個數據行。 如果數據列設定為 Null 值，則不會列印此值。

Private Sub PrintRows(dataSet As DataSet)
    Dim table As DataTable
    Dim column As DataColumn
    Dim row As DataRow
    For Each table In dataSet.Tables
       For Each row In table.Rows
          For Each column In table.Columns
             If Not row.IsNull(column) Then 
                Console.WriteLine(row(column).ToString())
             End If
          Next column
       Next row
     Next table
End Sub

IsNull(Int32)

來源:

DataRow.cs

取得值，指出指定之索引處的資料行是否包含 Null 值。

public:
 bool IsNull(int columnIndex);

public bool IsNull (int columnIndex);

member this.IsNull : int -> bool

Public Function IsNull (columnIndex As Integer) As Boolean

參數

columnIndex

Int32

資料行的以零起始的索引。

傳回

Boolean

如果資料行包含 Null 值，則為 true，否則為 false。

例外狀況

IndexOutOfRangeException

無資料行對應至 columnIndex 指定的索引。

RowNotInTableException

資料列不屬於資料表。

範例

下列範例會將數據行的值變更為 Null 值，然後使用 IsNull 方法來判斷值是否為 Null。

Private Sub IsValNull()
    ' Assuming the DataGrid is bound to a DataTable.
    Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)
    Dim row As DataRow = table.Rows(datagrid1.CurrentCell.RowNumber)
    row.BeginEdit
    row(1) = System.DBNull.Value
    row.EndEdit
    row.AcceptChanges
    Console.WriteLine(row.IsNull(1))
End Sub

IsNull(String)

來源:

DataRow.cs

取得值，指出具名資料行是否包含 Null 值。

public:
 bool IsNull(System::String ^ columnName);

public bool IsNull (string columnName);

member this.IsNull : string -> bool

Public Function IsNull (columnName As String) As Boolean

參數

columnName

String

資料行名稱。

傳回

Boolean

如果資料行包含 Null 值，則為 true，否則為 false。

例外狀況

ArgumentException

找不到 columnName 指定的資料行。

ArgumentNullException

columnName 為 null。

RowNotInTableException

資料列不屬於資料表。

範例

下列範例會將數據行的值變更為 Null 值，然後使用 IsNull 方法來判斷值是否為 Null。

 Private Sub IsValNull()
    ' Assuming the DataGrid is bound to a DataTable.
    Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)
    Dim row As DataRow = table.Rows(datagrid1.CurrentCell.RowNumber)
    row.BeginEdit
    row("FirstName") = System.DBNull.Value
    row.EndEdit
    row.AcceptChanges
    Console.WriteLine(row.IsNull("FirstName"))
End Sub

IsNull(DataColumn, DataRowVersion)

來源:

DataRow.cs

取得值，指出指定的 DataColumn 和 DataRowVersion 是否包含 Null 值。

public:
 bool IsNull(System::Data::DataColumn ^ column, System::Data::DataRowVersion version);

public bool IsNull (System.Data.DataColumn column, System.Data.DataRowVersion version);

member this.IsNull : System.Data.DataColumn * System.Data.DataRowVersion -> bool

Public Function IsNull (column As DataColumn, version As DataRowVersion) As Boolean

參數

column

DataColumn

DataColumn。

version

DataRowVersion

其中一個 DataRowVersion 值，指定資料列的版本。 可能的值為 Default、Original、Current 和 Proposed。

傳回

Boolean

如果資料行包含 Null 值，則為 true，否則為 false。

例外狀況

ArgumentNullException

column 為 null。

RowNotInTableException

資料列不屬於資料表。

VersionNotFoundException

資料列沒有要求的 version。