SqlDataReader.GetOrdinal(String) Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

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

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

public override int GetOrdinal (string name);

override this.GetOrdinal : string -> int

Public Overrides Function GetOrdinal (name As String) As Integer

Параметры

name

String

Имя столбца.

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

Int32

Порядковый номер столбца (от нуля).

Реализации

GetOrdinal(String)

Исключения

IndexOutOfRangeException

Заданное имя недопустимо для имени столбца.

Примеры

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

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadGetOrdinal(str);
    }

    private static void ReadGetOrdinal(string connectionString)
    {
        string queryString = "SELECT DISTINCT CustomerID FROM dbo.Orders;";
        using (SqlConnection connection =
                   new SqlConnection(connectionString))
        {
            SqlCommand command =
                new SqlCommand(queryString, connection);
            connection.Open();

            SqlDataReader reader = command.ExecuteReader();

            // Call GetOrdinal and assign value to variable.
            int customerID = reader.GetOrdinal("CustomerID");

            // Use variable with GetString inside of loop.
            while (reader.Read())
            {
                Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
            }

            // Call Close when done reading.
            reader.Close();
        }
    }
}

Комментарии

GetOrdinal сначала выполняет поиск с учетом регистра. В случае сбоя выполняется второй поиск без учета регистра (сравнение без учета регистра выполняется с помощью параметров сортировки базы данных). Непредвиденные результаты могут возникать, если на сравнение влияют правила регистра, относящиеся к языку и региональным параметрам. Например, в турецком языке следующий пример дает неправильные результаты, так как файловая система на турецком языке не использует правила лингвистического регистра для буквы "i" в "file". Метод создает исключение, IndexOutOfRange если порядковый номер столбца, отсчитываемый от нуля, не найден.

Метод GetOrdinal не учитывает ширину японской азбуки.

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