Partilhar via


DataRow.IsNull Método

Definição

Obtém um valor que indica se a coluna especificada contém um valor null.

Sobrecargas

IsNull(DataColumn)

Obtém um valor que indica se o DataColumn especificado contém um valor null.

IsNull(Int32)

Obtém um valor que indica se a coluna no índice especificado contém um valor nulo.

IsNull(String)

Obtém um valor que indica se a coluna nomeada contém um valor null.

IsNull(DataColumn, DataRowVersion)

Obtém um valor que indica se o DataColumn e DataRowVersion especificados contêm um valor nulo.

IsNull(DataColumn)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

Obtém um valor que indica se o DataColumn especificado contém um valor 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

Parâmetros

column
DataColumn

Um DataColumn.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.

Exceções

column é null.

A linha não pertence à tabela.

Exemplos

O exemplo a seguir imprime cada coluna de cada linha em cada tabela de um DataSet. Se a linha for definida como um valor nulo, o valor não será impresso.

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

Aplica-se a

IsNull(Int32)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

Obtém um valor que indica se a coluna no índice especificado contém um valor nulo.

public:
 bool IsNull(int columnIndex);
public bool IsNull (int columnIndex);
member this.IsNull : int -> bool
Public Function IsNull (columnIndex As Integer) As Boolean

Parâmetros

columnIndex
Int32

O índice com base em zero da coluna.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.

Exceções

Nenhuma coluna corresponde ao índice especificado por columnIndex.

A linha não pertence à tabela.

Exemplos

O exemplo a seguir altera o valor de uma coluna para um valor nulo e usa o IsNull método para determinar se o valor é nulo.

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

Aplica-se a

IsNull(String)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

Obtém um valor que indica se a coluna nomeada contém um valor 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

Parâmetros

columnName
String

O nome da coluna.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.

Exceções

A coluna especificada por columnName não pode ser encontrada.

columnName é null.

A linha não pertence à tabela.

Exemplos

O exemplo a seguir altera o valor de uma coluna para um valor nulo e usa o IsNull método para determinar se o valor é nulo.

 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

Aplica-se a

IsNull(DataColumn, DataRowVersion)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

Obtém um valor que indica se o DataColumn e DataRowVersion especificados contêm um valor nulo.

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

Parâmetros

column
DataColumn

Um DataColumn.

version
DataRowVersion

Um dos valores DataRowVersion que especifica a versão de linha. Os valores possíveis são Default, Original, Current e Proposed.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.

Exceções

column é null.

A linha não pertence à tabela.

A linha não tem o version solicitado.

Aplica-se a