DataTableReader.GetName(Int32) Methode

Definition

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

public:
 override System::String ^ GetName(int ordinal);
public override string GetName (int ordinal);
override this.GetName : int -> string
Public Overrides Function GetName (ordinal As Integer) As String

Parameter

ordinal
Int32

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

Gibt zurück

Der Name der angegebenen Spalte.The name 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, 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.

Beispiele

Das folgende einfache Beispiel enthält eine Prozedur, die die Namen aller Spalten innerhalb des angegebenen DataTableReaderund die Ordnungsposition der Spalte im Konsolenfenster auflistet.The following simple example includes a procedure that lists the names of all the columns within the specified DataTableReader, and the column's ordinal position, to the Console window.

private static void DisplayColumnNames(DataTableReader reader)
{
    // Given a DataTableReader, display column names.
    for (int i = 0; i < reader.FieldCount; i++) 
    {
        Console.WriteLine("{0}: {1}", i, reader.GetName(i));
    }
}
Private Sub DisplayColumnNames(ByVal reader As DataTableReader)
   ' Given a DataTableReader, display column names.
   For i As Integer = 0 To reader.FieldCount - 1
      Console.WriteLine("{0}: {1}", i, reader.GetName(i))
   Next
End Sub

Hinweise

Die Methoden GetName und GetOrdinal stellen eine umgekehrte Funktionalität bereit.The GetName and GetOrdinal methods provide inverse functionality. Das heißt, dass der Aufruf von GetOrdinal für den Rückgabewert des aufrufenden GetName den ursprünglichen an GetNameübergebenen Parameter zurückgeben soll. das gleiche gilt für den Aufruf der Prozeduren in umgekehrter Reihenfolge.That is, calling GetOrdinal on the return value of calling GetName should return the original parameter passed to GetName; the same applies to calling the procedures in the opposite order.

Gilt für: