OdbcDataReader.GetOrdinal(String) Método

public:
 override int GetOrdinal(System::String ^ value);

public:
 virtual int GetOrdinal(System::String ^ value);

public override int GetOrdinal(string value);

public int GetOrdinal(string value);

override this.GetOrdinal : string -> int

abstract member GetOrdinal : string -> int
override this.GetOrdinal : string -> int

Public Overrides Function GetOrdinal (value As String) As Integer

Public Function GetOrdinal (value As String) As Integer

Parâmetros

Devoluções

O ordinal da coluna baseada em zero.

Implementações

Exemplos

O exemplo seguinte demonstra como usar o GetOrdinal método.

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

Observações

GetOrdinal Faz primeiro uma pesquisa com sensibilidade a maiúsculas minúsculas. Se falhar, é feita uma segunda busca insensível a maiúsculas e minúsculas. O método lança uma IndexOutOfRange exceção se o ordinal da coluna baseado em zero não for encontrado.

GetOrdinal é insensível à largura de Kana.

Como as consultas baseadas em ordinais são mais eficientes do que as consultas nomeadas, é ineficiente chamar GetOrdinal dentro de um ciclo. Em vez disso, chama GetOrdinal uma vez e depois atribui os resultados a uma variável inteira para usar dentro do ciclo.

Ver também

• GetName(Int32)
• Adaptadores de Dados e Leitores de Dados