DataRow.IsNull DataRow.IsNull DataRow.IsNull DataRow.IsNull Method

Definição

Obtém um valor que indica se a coluna especificada contém um valor null.Gets a value that indicates whether the specified column contains a null value.

Sobrecargas

IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn)

Obtém um valor que indica se o DataColumn especificado contém um valor null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(Int32) IsNull(Int32) IsNull(Int32) IsNull(Int32)

Obtém um valor que indica se a coluna no índice especificado contém um valor nulo.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String) IsNull(String) IsNull(String) IsNull(String)

Obtém um valor que indica se a coluna nomeada contém um valor null.Gets a value that indicates whether the named column contains a null value.

IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion)

Obtém um valor que indica se o DataColumn e DataRowVersion especificados contêm um valor nulo.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn)

Obtém um valor que indica se o DataColumn especificado contém um valor null.Gets a value that indicates whether the specified DataColumn contains a null value.

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

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.true if the column contains a null value; otherwise, false.

Exceções

A linha não pertence à tabela.The row does not belong to the table.

Exemplos

O exemplo a seguir imprime cada coluna de cada linha em cada tabela de um DataSet.The following example prints each column of each row in each table of a DataSet. Se a linha é definida como um valor nulo, o valor não será impressa.If the row is set to a null value, the value is not printed.

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) IsNull(Int32) IsNull(Int32) IsNull(Int32)

Obtém um valor que indica se a coluna no índice especificado contém um valor nulo.Gets a value that indicates whether the column at the specified index contains a null value.

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 Int32 Int32 Int32

O índice com base em zero da coluna.The zero-based index of the column.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.true if the column contains a null value; otherwise, false.

Exceções

Nenhuma coluna corresponde ao índice especificado por columnIndex.No column corresponds to the index specified by columnIndex.

A linha não pertence à tabela.The row does not belong to the table.

Exemplos

O exemplo a seguir altera o valor de uma coluna com um valor nulo e, em seguida, usa o IsNull método para determinar se o valor é null.The following example changes the value of a column to a null value, and then uses the IsNull method to determine whether the value is 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) IsNull(String) IsNull(String) IsNull(String)

Obtém um valor que indica se a coluna nomeada contém um valor null.Gets a value that indicates whether the named column contains a null value.

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 String String String

O nome da coluna.The name of the column.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.true if the column contains a null value; otherwise, false.

Exceções

A coluna especificada por columnName não pode ser encontrada.The column specified by columnName cannot be found.

A linha não pertence à tabela.The row does not belong to the table.

Exemplos

O exemplo a seguir altera o valor de uma coluna com um valor nulo e, em seguida, usa o IsNull método para determinar se o valor é null.The following example changes the value of a column to a null value, and then uses the IsNull method to determine whether the value is 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) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion)

Obtém um valor que indica se o DataColumn e DataRowVersion especificados contêm um valor nulo.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

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

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

Um dos valores DataRowVersion que especifica a versão de linha.One of the DataRowVersion values that specifies the row version. Os valores possíveis são Default, Original, Current e Proposed.Possible values are Default, Original, Current, and Proposed.

Retornos

true se a coluna contiver um valor nulo; caso contrário, false.true if the column contains a null value; otherwise, false.

Exceções

A linha não pertence à tabela.The row does not belong to the table.

A linha não tem o version solicitado.The row does not have the requested version.

Aplica-se a