SqlDataReader.GetOrdinal(String) Methode

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.

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

public:
 virtual int GetOrdinal(System::String ^ name);

public override int GetOrdinal (string name);

public int GetOrdinal (string name);

override this.GetOrdinal : string -> int

abstract member GetOrdinal : string -> int
override this.GetOrdinal : string -> int

Public Overrides Function GetOrdinal (name As String) As Integer

Public Function GetOrdinal (name As String) As Integer

Parameter

name: String

Der Name der Spalte.

Gibt zurück

Int32

Die nullbasierte Ordnungszahl der Spalte.

Implementiert

GetOrdinal(String)

Ausnahmen

IndexOutOfRangeException

Der angegebene Name ist kein gültiger Spaltenname.

Beispiele

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

private static void ReadGetOrdinal(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM dbo.Orders;";
    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

        SqlDataReader reader = command.ExecuteReader();

        // Call GetOrdinal and assign value to variable.
        int customerID = reader.GetOrdinal("CustomerID");

        // Use variable with GetString inside of loop.
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
        }

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

Private Sub ReadGetOrdinal(ByVal connectionString As String)
    Dim queryString As String = _
       "SELECT DISTINCT CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call GetOrdinal and assign value to variable.
        Dim customerID As Integer = reader.GetOrdinal("CustomerID")

        ' Use variable with GetString inside of loop.
        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 zwischen Groß- und Kleinschreibung durch. Wenn ein Fehler auftritt, erfolgt eine zweite Suche ohne Berücksichtigung der Groß-/Kleinschreibung (ein Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung wird mithilfe der Datenbanksortierung durchgeführt). Unerwartete Ergebnisse können auftreten, wenn Vergleiche durch kulturspezifische Groß-/Kleinschreibungsregeln beeinflusst werden. Beispielsweise liefert das folgende Beispiel die falschen Ergebnisse, da das Dateisystem auf Türkisch keine linguistischen Groß-/Kleinschreibungsregeln für den Buchstaben "i" in "file" verwendet. 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. Sparen Sie Zeit, indem Sie GetOrdinal einmal aufrufen und die Ergebnisse für die Verwendung innerhalb der Schleife an eine Integervariable zuweisen.

Gilt für: