OleDbDataReader.GetOrdinal-Methode

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.

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

Syntax

'Declaration
Public Overrides Function GetOrdinal ( _
    name As String _
) As Integer
'Usage
Dim instance As OleDbDataReader
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.

Ausnahmen

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

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

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()

        Dim customerID As Integer = reader.GetOrdinal("CustomerID")
        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
        End While
        reader.Close()
    End Using
End Sub

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

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

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

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

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        string x = "Provider=SQLOLEDB;Data Source=(local);Integrated Security=SSPI;Initial Catalog=Northwind";
        ReadData(x);
    }

    public static void ReadData(string connectionString)
    {
        string queryString = "SELECT DISTINCT CustomerID FROM Orders";
        using (OleDbConnection connection = new OleDbConnection(connectionString))
        {
            OleDbCommand command = new OleDbCommand(queryString, connection);

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

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

            while (reader.Read())
            {
                Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
            }
            reader.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, 1.0

Siehe auch

Referenz

OleDbDataReader-Klasse
OleDbDataReader-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit DataReaders