OleDbDataReader.GetOrdinal(String) Метод

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v9.0.0-rc.2.24473.5

Исходный код:

OleDbDataReader.cs

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

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

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

Исключения

IndexOutOfRangeException

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

Примеры

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

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        int customerID = reader.GetOrdinal("CustomerID");

        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
        }
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()

        Dim customerID As Integer = reader.GetOrdinal("CustomerID")
        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
        End While
        reader.Close()
    End Using
End Sub

Комментарии

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

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

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

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

• Объекты DataAdapter и DataReader