OdbcDataReader.GetOrdinal(String) Methode

Definition

Namespace:
System.Data.Odbc
Assembly:
System.Data.dll

Ruft die Spalten-Ordnungszahl ab, wobei der Name der Spalte angegeben ist.

public:
 virtual int GetOrdinal(System::String ^ value);
public:
 override int GetOrdinal(System::String ^ value);
public int GetOrdinal(string value);
public override int GetOrdinal(string value);
abstract member GetOrdinal : string -> int
override this.GetOrdinal : string -> int
override this.GetOrdinal : string -> int
Public Function GetOrdinal (value As String) As Integer
Public Overrides Function GetOrdinal (value As String) As Integer

Parameter

value
String

Der Name der Spalte.

Gibt zurück

Int32

Die nullbasierte Spalten-Ordnungszahl.

Implementiert

GetOrdinal(String)

Beispiele

Im folgenden Beispiel wird die Verwendung der GetOrdinal Methode veranschaulicht.

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();
    }
}

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

Hinweise

GetOrdinal führt zuerst eine Nachschlagevorgang mit Groß-/Kleinschreibung durch. Wenn ein Fehler auftritt, wird eine zweite Suche ohne Groß-/Kleinschreibung durchgeführt. Die Methode löst eine IndexOutOfRange Ausnahme aus, wenn die nullbasierte Spalten-Ordnungszahl nicht gefunden wird.

GetOrdinal ist kana-width insensitiv.

Da Ordinalbasierte Nachschlagevorgänge effizienter sind als benannte Nachschlagevorgänge, ist es ineffizient, innerhalb einer Schleife aufzurufen GetOrdinal . Rufen Sie stattdessen einmal auf GetOrdinal , und weisen Sie die Ergebnisse einer ganzzahligen Variablen für die Verwendung in der Schleife zu.

Gilt für:

Weitere Informationen