IDataRecord.GetOrdinal(String) Método

Definición

Devuelve el índice del campo con nombre.Return the index of the named field.

public:
 int GetOrdinal(System::String ^ name);
public int GetOrdinal (string name);
abstract member GetOrdinal : string -> int
Public Function GetOrdinal (name As String) As Integer

Parámetros

name
String

El nombre del campo que se va a buscar.The name of the field to find.

Devoluciones

El índice del campo con nombre.The index of the named field.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el método heredado GetOrdinal.The following example demonstrates how to use the inherited GetOrdinal method.

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

Comentarios

GetOrdinal realiza primero una búsqueda que distingue entre mayúsculas y minúsculas.GetOrdinal performs a case-sensitive lookup first. Si se produce un error, se realiza una segunda búsqueda sin distinción de mayúsculas y minúsculas.If it fails, a second case-insensitive search is made. GetOrdinal no distingue el ancho de Kana.GetOrdinal is kana-width insensitive. Si no se encuentra el índice del campo con nombre, se produce una IndexOutOfRangeException.If the index of the named field is not found, an IndexOutOfRangeException is thrown.

Dado que las búsquedas basadas en ordinales son más eficaces que las búsquedas con nombre, no es eficaz llamar a GetOrdinal dentro de un bucle.Because ordinal-based lookups are more efficient than named lookups, it is inefficient to call GetOrdinal within a loop. Ahorre tiempo llamando GetOrdinal una vez y asignando los resultados a una variable de entero para su uso dentro del bucle.Save time by calling GetOrdinal one time and assigning the results to an integer variable for use within the loop.

Se aplica a