OdbcDataReader.GetOrdinal(String) Methode

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v8.0.0

Quelle:

OdbcDataReader.cs

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.

public:
 override int GetOrdinal(System::String ^ value);

public override int GetOrdinal (string value);

override this.GetOrdinal : string -> int

Public Overrides Function GetOrdinal (value As String) As Integer

Parameter

value

String

Der Name der Spalte.

Gibt zurück

Int32

Die nullbasierte Ordnungszahl der Spalte.

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 Nachbereinigung der Groß-/Kleinschreibung durch. Wenn ein Fehler auftritt, wird eine zweite Suche ohne Beachtung der Groß-/Kleinschreibung durchgeführt. Die -Methode löst eine Ausnahme aus IndexOutOfRange , wenn die nullbasierte Spalten ordnungszahl nicht gefunden wird.

GetOrdinal berücksichtigt die Laufweite von Kana nicht.

Da Nachschlagevorgänge auf der Basis von Ordinalzahlen effizienter sind als Nachschlagevorgänge nach Namen, ist der Aufruf von GetOrdinal innerhalb einer Schleife ineffizient. Rufen Sie stattdessen einmal auf GetOrdinal , und weisen Sie die Ergebnisse dann einer ganzzahligen Variablen zur Verwendung innerhalb der Schleife zu.

Weitere Informationen

• GetName(Int32)
• "DataAdapters" und "DataReaders"