DataTableReader.GetByte(Int32) Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.dll

Ruft den Wert der angegebenen Spalte als Byte ab.

public:
 override System::Byte GetByte(int ordinal);

public override byte GetByte(int ordinal);

override this.GetByte : int -> byte

Public Overrides Function GetByte (ordinal As Integer) As Byte

Parameter

ordinal

Int32

Die nullbasierte Spalten-Ordnungszahl.

Gibt zurück

Byte

Der Wert der angegebenen Spalte.

Ausnahmen

ArgumentOutOfRangeException

Der übergebene Index liegt außerhalb des Bereichs von 0 bis FieldCount -1.

DeletedRowInaccessibleException

Es wurde versucht, Daten aus einer gelöschten Zeile abzurufen.

InvalidOperationException

Es wurde versucht, eine Spalte in einer geschlossenen DataTableReaderSpalte zu lesen oder darauf zuzugreifen.

InvalidCastException

Die angegebene Spalte enthält kein Byte.

Beispiele

Im folgenden Beispiel wird der Inhalt der Spalte 2 innerhalb des übergebenen DataTableReaderElements angezeigt. Wenn der Wert der Spalte in einer bestimmten Zeile NULL ist, zeigt der Code den Text <NULL> an. Wenn die Daten in der Spalte nicht vom richtigen Typ sind, zeigt das Beispiel eine Fehlermeldung für jede Zeile an.

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.GetByte(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.GetByte(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 bereits ein Byte oder ein Byte sein.

Rufen Sie IsDBNull auf, um festzustellen, ob null Werte vorhanden sind, bevor Sie diese Methode aufrufen.