DataTableReader.GetName(Int32) Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Quelle:

DataTableReader.cs

Ruft den Wert der angegebenen Spalte als String ab.

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.

Gibt zurück

String

Der Name der angegebenen Spalte.

Ausnahmen

ArgumentOutOfRangeException

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

InvalidOperationException

Es wurde versucht, eine Spalte in einem geschlossenen DataTableReader zu lesen oder darauf zuzugreifen.

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.

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 GetName Methoden und GetOrdinal bieten umgekehrte Funktionen. Das heißt, das Aufrufen GetOrdinal des Rückgabewerts von calling GetName sollte den ursprünglichen Parameter zurückgeben, der an GetNameübergeben wurde. Dasselbe gilt für das Aufrufen der Prozeduren in der entgegengesetzten Reihenfolge.