SqlDataReader.GetOrdinal(String) Метод

Определение

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

System.Data.SqlClient

Сборка:

System.Data.SqlClient.dll

Пакет:

System.Data.SqlClient v4.8.6

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

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.

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

Private Sub ReadGetOrdinal(ByVal connectionString As String)
    Dim queryString As String = _
       "SELECT DISTINCT CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call GetOrdinal and assign value to variable.
        Dim customerID As Integer = reader.GetOrdinal("CustomerID")

        ' Use variable with GetString inside of loop.
        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Комментарии

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

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

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

См. также раздел

• Объекты DataAdapter и DataReader (ADO.NET)
• SQL Server и ADO.NET
• Общие сведения об ADO.NET