OdbcDataReader.GetOrdinal(String) Метод

Определение

Возвращает порядковый номер столбца при наличии заданного имени столбца.Gets the column ordinal, given the name of the column.

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

Параметры

value
String

Имя столбца.The name of the column.

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

Порядковый номер столбца (от нуля).The zero-based column ordinal.

Реализации

Примеры

В следующем примере показано использование метода GetOrdinal.The following example demonstrates how to use the GetOrdinal method.

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

Комментарии

GetOrdinal сначала выполняет поиск с учетом регистра.GetOrdinal performs a case-sensitive lookup first. В случае сбоя выполняется второй Поиск без учета регистра.If it fails, a second case-insensitive search is made. Метод вызывает исключение IndexOutOfRange, если порядковый номер столбца, начинающийся с нуля, не найден.The method throws an IndexOutOfRange exception if the zero-based column ordinal is not found.

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

Поиск по порядковым числительным более эффективен, чем поиск по имени, поэтому не рекомендуется использовать метод GetOrdinal в цикле.Because ordinal-based lookups are more efficient than named lookups, it is inefficient to call GetOrdinal within a loop. Вместо этого вызовите GetOrdinal один раз и затем присвойте результаты целочисленной переменной для использования в цикле.Instead, call GetOrdinal one time and then assign the results to an integer variable for use within the loop.

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

Дополнительно