DataTableReader.IsDBNull, méthode (System.Data)

Changer de vue:
Classique
Lightweight
ScriptFree
Bibliothèque de classes .NET Framework
DataTableReader.IsDBNull, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

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

Espace de noms : System.Data
Assembly : System.Data (dans system.data.dll)

Syntaxe
Visual Basic (Déclaration)
Public Overrides Function IsDBNull ( _
	ordinal As Integer _
) As Boolean
Visual Basic (Utilisation)
Dim instance As DataTableReader
Dim ordinal As Integer
Dim returnValue As Boolean

returnValue = instance.IsDBNull(ordinal)
C#
public override bool IsDBNull (
	int ordinal
)
C++
public:
virtual bool IsDBNull (
	int ordinal
) override
J#
public boolean IsDBNull (
	int ordinal
)
JScript
public override function IsDBNull (
	ordinal : int
) : boolean

Paramètres

ordinal

Ordinal de colonne de base zéro

Valeur de retour

true si la valeur de colonne spécifiée équivaut à DBNull ; sinon, false.
Exceptions
Type d'exception Condition

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 a été effectuée pour lire une colonne ou y accéder dans un DataTableReader fermé.
Notes

Appelez cette méthode pour voir s'il existe des valeurs de colonnes null avant d'appeler les méthodes Get typées (par exemple, GetByte, GetChar, etc.) afin d'éviter toute erreur.

Exemple

L'exemple suivant affiche le contenu de la colonne numéro 2 dans le DataTableReader passé. 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 ne sont pas du type approprié, l'exemple affiche un message d'erreur pour chaque ligne.

Visual Basic
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
C#
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();
    }
}
Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0

.NET Compact Framework

Prise en charge dans : 2.0
Voir aussi