DataTableReader.GetBoolean(Int32) Methode

Definition

Ruft den Wert der angegebenen Spalte als Boolean ab.Gets the value of the specified column as a Boolean.

public:
 override bool GetBoolean(int ordinal);
public override bool GetBoolean (int ordinal);
override this.GetBoolean : int -> bool
Public Overrides Function GetBoolean (ordinal As Integer) As Boolean

Parameter

ordinal
Int32

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

Gibt zurück

Der Wert der angegebenen Spalte.The value of the specified column.

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 darauf zuzugreifen.An attempt was made to read or access a column in a closed DataTableReader.

Die angegebene Spalte enthält keinen Boolean.The specified column does not contain a Boolean.

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 nicht den richtigen Typ haben, zeigt das Beispiel eine Fehlermeldung für jede Zeile an.If the data within the column is not 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.GetBoolean(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.GetBoolean(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

Hinweise

Es werden keine Konvertierungen ausgeführt. Daher müssen die abgerufenen Daten entweder ein boolescher Wert sein oder in einen booleschen Wert umgewandelt werden, oder es wird eine Ausnahme generiert.No conversions are performed; therefore the data retrieved must either already be a Boolean or coercible to a Boolean, or an exception is generated.

Rufen Sie IsDBNull auf, um festzustellen, ob vor dem Aufruf dieser Methode NULL-Werte vorhanden sindCall IsDBNull to see if there are null values before calling this method.

Gilt für: