IDataRecord.GetOrdinal(String) Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Gibt den Index des benannten Felds zurück.

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.

Gibt zurück

Int32

Der Index des benannten Felds.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie die geerbte GetOrdinal Methode verwenden.

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 Groß-/Kleinschreibung durch. Wenn es fehlschlägt, wird eine zweite Groß- und Kleinschreibungssuche vorgenommen. GetOrdinal berücksichtigt die Laufweite von Kana nicht. Wenn der Index des benannten Felds nicht gefunden wird, wird ein IndexOutOfRangeException Wurf ausgelöst.

Da Nachschlagevorgänge auf der Basis von Ordinalzahlen effizienter sind als Nachschlagevorgänge nach Namen, ist der Aufruf von GetOrdinal innerhalb einer Schleife ineffizient. Sparen Sie Zeit, indem Sie einmal aufrufen GetOrdinal und die Ergebnisse einer ganzzahligen Variable für die Verwendung innerhalb der Schleife zuweisen.