Прочитать на английском

Поделиться через


IDataRecord.GetOrdinal(String) Метод

Определение

Возвращает индекс именованного поля.

public int GetOrdinal(string name);

Параметры

name
String

Имя искомого поля.

Возвращаемое значение

Индекс именованного поля.

Примеры

В следующем примере показано, как использовать наследуемый GetOrdinal метод.

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

Комментарии

GetOrdinal сначала выполняет поиск с учетом регистра. В случае сбоя выполняется второй поиск без учета регистра. Метод GetOrdinal не учитывает ширину японской азбуки. Если индекс именованного поля не найден, возникает исключение IndexOutOfRangeException .

Поиск по порядковым числительным более эффективен, чем поиск по имени, поэтому не рекомендуется использовать метод GetOrdinal в цикле. Экономьте время, вызвав GetOrdinal один раз и назначив результаты целочисленной переменной для использования в цикле.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.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, 2.1