OracleDataReader.GetOrdinal-Methode

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.

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

Syntax

'Declaration
Public Overrides Function GetOrdinal ( _
    name As String _
) As Integer
'Usage
Dim instance As OracleDataReader
Dim name As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(name)

public override int GetOrdinal (
    string name
)

public:
virtual int GetOrdinal (
    String^ name
) override

public int GetOrdinal (
    String name
)

public override function GetOrdinal (
    name : String
) : int

Parameter

• name
  Der Name der Spalte.

Rückgabewert

Die nullbasierte Ordnungszahl der Spalte.

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. Rufen Sie stattdessen einmal GetOrdinal auf, und weisen Sie anschließend die Ergebnisse einer Ganzzahlvariablen zu, die in der Schleife verwendet wird.

Beispiel

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

[Visual Basic]

Public Sub ReadOracleData(ByVal connectionString As String)

    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Dim connection As New OracleConnection(connectionString)
    Dim command As New OracleCommand(queryString, connectionString)

    connection.Open()

    Dim reader As OracleDataReader = command.ExecuteReader()

    Dim custIdCol As Integer = reader.GetOrdinal("CustomerID")

    Do While reader.Read()
        Console.WriteLine("CustomerID = {0}", reader.GetString(custIdCol))
    Loop

    reader.Close()
    connection.Close()
End Sub

[C#]

public void ReadOracleData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    OracleConnection connection = new OracleConnection(connectionString);
    OracleCommand command = new OracleCommand(queryString,connection);

    connection.Open();
    OracleDataReader reader = command.ExecuteReader();

    int custIdCol = reader.GetOrdinal("CustomerID");

    while (reader.Read())
        Console.WriteLine("CustomerID = {0}", reader.GetString(custIdCol));

    reader.Close();
    connection.Close();
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

OracleDataReader-Klasse
OracleDataReader-Member
System.Data.OracleClient-Namespace