OdbcDataReader.GetOrdinal(String) 메서드

정의

열 이름이 지정된 경우 열 서수를 가져옵니다.Gets the column ordinal, given the name of the column.

public:
 virtual int GetOrdinal(System::String ^ value);
public int GetOrdinal (string value);
override this.GetOrdinal : string -> int
Public Function GetOrdinal (value As String) As Integer

매개 변수

value
String

열 이름입니다.The name of the column.

반환

열 서수(0부터 시작)입니다.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. 메서드에서 throw 한 IndexOutOfRange 0부터 시작 하는 열 서 수 없는 경우 예외입니다.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.

적용 대상

추가 정보