IDataRecord.GetOrdinal(String) Methode

Definition

Gibt den Index des benannten Felds zurück.Return the index of the named field.

public:
 int GetOrdinal(System::String ^ name);
public int GetOrdinal (string name);
abstract member GetOrdinal : string -> int
Public Function GetOrdinal (name As String) As Integer

Parameter

name
String

Der Name des zu suchenden Felds.The name of the field to find.

Gibt zurück

Der Index des benannten Felds.The index of the named field.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die geerbte GetOrdinal-Methode verwendet wird.The following example demonstrates how to use the inherited GetOrdinal method.

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 Suche mit Berücksichtigung der Groß-und Kleinschreibung durch.GetOrdinal performs a case-sensitive lookup first. Bei einem Fehler wird eine zweite Suche ohne Beachtung der Groß-/Kleinschreibung durchgeführt.If it fails, a second case-insensitive search is made. GetOrdinal ist eine nicht-Breite von Kana.GetOrdinal is kana-width insensitive. Wenn der Index des benannten Felds nicht gefunden wird, wird ein IndexOutOfRangeException ausgelöst.If the index of the named field is not found, an IndexOutOfRangeException is thrown.

Da ordinalbasierte Suchvorgänge effizienter als benannte suchen sind, ist es ineffizient, GetOrdinal innerhalb einer Schleife aufzurufen.Because ordinal-based lookups are more efficient than named lookups, it is inefficient to call GetOrdinal within a loop. Sparen Sie Zeit, indem Sie GetOrdinal einmal aufrufen und die Ergebnisse einer ganzzahligen Variablen zur Verwendung innerhalb der Schleife zuweisen.Save time by calling GetOrdinal one time and assigning the results to an integer variable for use within the loop.

Gilt für: