DataTableReader.IsDBNull(Int32) Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataTableReader.cs

Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.

public:
 override bool IsDBNull(int ordinal);

public override bool IsDBNull (int ordinal);

override this.IsDBNull : int -> bool

Public Overrides Function IsDBNull (ordinal As Integer) As Boolean

Paramètres

ordinal

Int32

Numéro de colonne de base zéro.

Retours

Boolean

true si la valeur de colonne spécifiée équivaut à DBNull ; sinon, false.

Exceptions

ArgumentOutOfRangeException

L'index passé était en dehors de la plage comprise entre 0 et FieldCount - 1.

DeletedRowInaccessibleException

Une tentative a été effectuée pour récupérer des données à partir d'une ligne supprimée.

InvalidOperationException

Une tentative de lecture d’une colonne ou d’accès à une colonne dans un DataTableReader fermé a été effectuée.

Exemples

L’exemple suivant affiche le contenu de la colonne numérotée 2 dans le passé DataTableReader. Si la valeur de la colonne dans une ligne particulière est null, le code affiche le texte <NULL>. Si les données de la colonne du type correct sont affichées, l’exemple affiche un message d’erreur pour chaque ligne.

private static void PrintColumn(DataTableReader reader)
{
    // Loop through all the rows in the DataTableReader
    while (reader.Read())
    {
        if (reader.IsDBNull(2))
        {
            Console.Write("<NULL>");
        }
        else
        {
            try
            {
                Console.Write(reader.GetString(2));
            }
            catch (InvalidCastException)
            {
                Console.Write("Invalid data type.");
            }
        }
        Console.WriteLine();
    }
}

Private Sub PrintColumn(ByVal reader As DataTableReader)
   ' Loop through all the rows in the DataTableReader
   While reader.Read()
      If reader.IsDBNull(2) Then
         Console.Write("<NULL>")
      Else
         Try
            Console.Write(reader.GetString(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

Remarques

Appelez cette méthode pour voir s’il existe des valeurs de colonne Null avant d’appeler les méthodes get typées (par exemple, GetByte, GetChar, etc.) pour éviter de déclencher une erreur.