DataRow.IsNull Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Obtient une valeur qui indique si la colonne spécifiée contient une valeur null.

Surcharges

IsNull(DataColumn)	Obtient une valeur qui indique si le DataColumn spécifié contient une valeur null.
IsNull(Int32)	Obtient une valeur qui indique si la colonne à l'index spécifié contient une valeur null.
IsNull(String)	Obtient une valeur qui indique si la colonne nommée contient une valeur null.
IsNull(DataColumn, DataRowVersion)	Obtient une valeur qui indique si le DataColumn et le DataRowVersion spécifiés contiennent une valeur null.

IsNull(DataColumn)

Source:

DataRow.cs

Obtient une valeur qui indique si le DataColumn spécifié contient une valeur 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

Paramètres

column

DataColumn

DataColumn

Retours

Boolean

true si la colonne contient une valeur null ; sinon, false.

Exceptions

ArgumentNullException

column a la valeur null.

RowNotInTableException

La ligne n'appartient pas à la table.

Exemples

L’exemple suivant imprime chaque colonne de chaque ligne dans chaque table d’un DataSet. Si la ligne est définie sur une valeur Null, la valeur n’est pas imprimée.

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)

Source:

DataRow.cs

Obtient une valeur qui indique si la colonne à l'index spécifié contient une valeur null.

public:
 bool IsNull(int columnIndex);

public bool IsNull (int columnIndex);

member this.IsNull : int -> bool

Public Function IsNull (columnIndex As Integer) As Boolean

Paramètres

columnIndex

Int32

Index de base zéro de la colonne.

Retours

Boolean

true si la colonne contient une valeur null ; sinon, false.

Exceptions

IndexOutOfRangeException

Aucune colonne ne correspond à l'index spécifié par columnIndex.

RowNotInTableException

La ligne n'appartient pas à la table.

Exemples

L’exemple suivant remplace la valeur d’une colonne par une valeur Null, puis utilise la IsNull méthode pour déterminer si la valeur est 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)

Source:

DataRow.cs

Obtient une valeur qui indique si la colonne nommée contient une valeur 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

Paramètres

columnName

String

Nom de la colonne.

Retours

Boolean

true si la colonne contient une valeur null ; sinon, false.

Exceptions

ArgumentException

La colonne spécifiée par columnName est introuvable.

ArgumentNullException

columnName a la valeur null.

RowNotInTableException

La ligne n'appartient pas à la table.

Exemples

L’exemple suivant remplace la valeur d’une colonne par une valeur Null, puis utilise la IsNull méthode pour déterminer si la valeur est 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)

Source:

DataRow.cs

Obtient une valeur qui indique si le DataColumn et le DataRowVersion spécifiés contiennent une valeur 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

Paramètres

column

DataColumn

DataColumn

version

DataRowVersion

Une des valeurs DataRowVersion qui spécifie la version de ligne. Les valeurs possibles sont Default, Original, Current et Proposed.

Retours

Boolean

true si la colonne contient une valeur null ; sinon, false.

Exceptions

ArgumentNullException

column a la valeur null.

RowNotInTableException

La ligne n'appartient pas à la table.

VersionNotFoundException

La ligne ne contient pas le version demandé.