DataTableReader.IsDBNull(Int32) Methode

Definition

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Gets a value that indicates whether the column contains non-existent or missing values.

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

Parameter

ordinal
Int32

Die nullbasierte Ordnungszahl der Spalte.The zero-based column ordinal

Gibt zurück

true, wenn der angegebene Spaltenwert DBNull entspricht, andernfalls false.true if the specified column value is equivalent to DBNull; otherwise, false.

Ausnahmen

Der übergebene Index lag außerhalb des Bereichs von 0 bis FieldCount -1.The index passed was outside the range of 0 to FieldCount - 1.

Es wurde versucht, Daten aus einer gelöschten Zeile abzurufen.An attempt was made to retrieve data from a deleted row.

Es wurde versucht, eine Spalte in einem geschlossenen DataTableReader zu lesen oder auf sie zuzugreifen.An attempt was made to read or access a column in a closed DataTableReader .

Beispiele

Im folgenden Beispiel wird der Inhalt der Spalte mit der Nummer 2 innerhalb des DataTableReaderder Übergabe angezeigt.The following example displays the contents of the column numbered 2 within the passed-in DataTableReader. Wenn der Wert für die Spalte in einer bestimmten Zeile NULL ist, zeigt der Code den Text <NULL-> an.If the value the column within a particular row is null, the code displays the text <NULL>. Wenn die Daten in der Spalte des richtigen Typs angezeigt werden, zeigt das Beispiel eine Fehlermeldung für jede Zeile an.If the data within the column of the correct type, the example displays an error message for each row.

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

Hinweise

Rufen Sie diese Methode auf, um festzustellen, ob NULL-Spaltenwerte vorhanden sind, bevor Sie die typisierten Get-Methoden aufrufen (z. b. GetByte, GetCharusw.), um eine Fehlermeldung zu vermeiden.Call this method to see if there are null column values before calling the typed get methods (for example, GetByte, GetChar, and so on) to avoid raising an error.

Gilt für: