IDataRecord.GetOrdinal(String) Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

IDataRecord.cs

Vrátí index pojmenovaného pole.

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

public int GetOrdinal(string name);

abstract member GetOrdinal : string -> int

Public Function GetOrdinal (name As String) As Integer

Parametry

name

String

Název pole, které chcete najít.

Návraty

Int32

Index pojmenovaného pole.

Příklady

Následující příklad ukazuje, jak použít zděděnou GetOrdinal metodu.

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

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

Poznámky

GetOrdinal provede nejprve vyhledávání s rozlišováním velkých a malých písmen. Pokud selže, provede se druhé vyhledávání bez rozlišování velkých a malých písmen. GetOrdinal nerozlišuje šířku kana. Pokud se index pojmenovaného pole nenajde, vyvolá se chyba IndexOutOfRangeException .

Vzhledem k tomu, že pořadové vyhledávání je efektivnější než pojmenované vyhledávání, je neefektivní volat GetOrdinal ve smyčce. Ušetřete čas voláním jednorázového volání GetOrdinal a přiřazením výsledků k celočíselné proměnné pro použití ve smyčce.