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

Значение true, если столбец содержит значение null; в противном случае — значение 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

Значение true, если столбец содержит значение null; в противном случае — значение 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

Значение true, если столбец содержит значение null; в противном случае — значение 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

Значение true, если столбец содержит значение null; в противном случае — значение false.

Исключения

ArgumentNullException

column имеет значение null.

RowNotInTableException

Строка не принадлежит таблице.

VersionNotFoundException

Строка не имеет запрошенного объекта version.