Ler em inglês

Partilhar via


OdbcDataReader.GetOrdinal(String) Método

Definição

Obtém a ordinal da coluna, de acordo com o nome da coluna.

C#
public override int GetOrdinal (string value);
C#
public int GetOrdinal (string value);

Parâmetros

value
String

O nome da coluna.

Retornos

O ordinal da coluna baseado em zero.

Implementações

Exemplos

O exemplo a seguir demonstra como usar o GetOrdinal método .

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

Comentários

GetOrdinal executa uma pesquisa que diferencia maiúsculas de minúsculas primeiro. Se falhar, uma segunda pesquisa que não diferencia maiúsculas de minúsculas será feita. O método gerará uma exceção IndexOutOfRange se o ordinal de coluna baseado em zero não for encontrado.

GetOrdinal não distingue largura de kana.

Como pesquisas baseadas em ordinais são mais eficientes do que pesquisas por nome, é ineficiente chamar GetOrdinal dentro de um loop. Em vez disso, chame GetOrdinal uma vez e atribua os resultados a uma variável de inteiro para uso dentro do loop.

Aplica-se a

Produto Versões
.NET 8 (package-provided), 9 (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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Confira também