OleDbDataReader.GetOrdinal(String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.OleDb

Zestaw:: System.Data.OleDb.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.OleDb v10.0.0-preview.1.25080.5

Źródło:: OleDbDataReader.cs

Źródło:: OleDbDataReader.cs

Źródło:: OleDbDataReader.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera porządkową kolumnę, podając nazwę kolumny.

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

Parametry

name: String

Nazwa kolumny.

Zwraca

Int32

Liczba porządkowa kolumn opartych na zerach.

Implementuje

GetOrdinal(String)

Wyjątki

IndexOutOfRangeException

Określona nazwa nie jest prawidłową nazwą kolumny.

Przykłady

W poniższym przykładzie pokazano, jak używać GetOrdinal metody .

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

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

Uwagi

GetOrdinal najpierw wykonuje wyszukiwanie uwzględniające wielkość liter. W przypadku niepowodzenia zostanie wykonane drugie wyszukiwanie bez uwzględniania wielkości liter. Metoda zgłasza IndexOutOfRange wyjątek, jeśli nie znaleziono porządkowej kolumny opartej na zerze.

GetOrdinal jest niewrażliwa na szerokość kana.

Ponieważ wyszukiwania na podstawie porządkowych są bardziej wydajne niż nazwane wyszukiwania, jest nieefektywne wywołanie GetOrdinal w ramach pętli. Oszczędzaj czas, wywołując GetOrdinal jednorazowo i przypisując wyniki do zmiennej całkowitej do użycia w pętli.

Dotyczy

Produkt	Wersje
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Zobacz też

Elementy DataAdapter i DataReader

Udostępnij za pośrednictwem