OdbcDataReader.GetOrdinal-Methode

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.

Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Function GetOrdinal ( _
    value As String _
) As Integer
'Usage
Dim instance As OdbcDataReader
Dim value As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(value)

public override int GetOrdinal (
    string value
)

public:
virtual int GetOrdinal (
    String^ value
) override

public int GetOrdinal (
    String value
)

public override function GetOrdinal (
    value : String
) : int

Parameter

• value
  Der Name der Spalte.

Rückgabewert

Die nullbasierte Ordnungszahl der Spalte.

Hinweise

GetOrdinal führt zuerst eine Suche durch, bei der die Groß- und Kleinschreibung berücksichtigt wird. Wenn diese fehlschlägt, wird eine Suche durchgeführt, bei der die Groß- und Kleinschreibung nicht berücksichtigt wird.

Bei GetOrdinal wird die Kana-Breite nicht berücksichtigt.

Da auf Ordnungszahlen basierende Suchvorgänge effizienter sind als auf Namen basierende Suchvorgänge, ist ein Aufruf von GetOrdinal in einer Schleife ineffizient. Rufen Sie stattdessen einmal GetOrdinal auf, und weisen Sie anschließend die Ergebnisse einer Ganzzahlvariablen zu, die in der Schleife verwendet wird.

Beispiel

Im folgenden Beispiel wird die Verwendung der GetOrdinal-Methode veranschaulicht.

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        Dim customerID As Integer = reader.GetOrdinal("CustomerID")

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();
        OdbcDataReader reader = command.ExecuteReader();

        int customerID = reader.GetOrdinal("CustomerID");

        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
        }

        // Call Close when done reading.
        reader.Close();
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OdbcDataReader-Klasse
OdbcDataReader-Member
System.Data.Odbc-Namespace
GetName

Weitere Ressourcen

Arbeiten mit DataReaders