IDataRecord.GetOrdinal-Methode

Zurückgeben des Indexes des benannten Felds.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Function GetOrdinal ( _
    name As String _
) As Integer
'Usage
Dim instance As IDataRecord
Dim name As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(name)

int GetOrdinal (
    string name
)

int GetOrdinal (
    String^ name
)

int GetOrdinal (
    String name
)

function GetOrdinal (
    name : String
) : int

Parameter

• name
  Der Name des gesuchten Felds.

Rückgabewert

Der Index des benannten Felds.

Hinweise

GetOrdinal führt zuerst eine Suche durch, bei der die Groß- und Kleinschreibung berücksichtigt wird. Wenn diese fehlschlägt, wird eine Suche durchgeführt, bei der die Groß- und Kleinschreibung nicht berücksichtigt wird.

Bei GetOrdinal wird die Kana-Breite nicht berücksichtigt.

Da auf Ordnungszahlen basierende Suchvorgänge effizienter sind als auf Namen basierende Suchvorgänge, ist ein Aufruf von GetOrdinal in einer Schleife ineffizient. Sie können Zeit sparen, indem Sie GetOrdinal einmal aufrufen und die Ergebnisse einer Ganzzahlvariablen zuweisen, die in der Schleife verwendet wird.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der geerbten GetOrdinal-Methode.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDataRecord-Schnittstelle
IDataRecord-Member
System.Data-Namespace