다음을 통해 공유

IDataRecord.GetOrdinal 메서드

  • 아티클

이름이 지정된 필드의 인덱스를 반환합니다.

네임스페이스: System.Data
어셈블리: System.Data(system.data.dll)

구문

‘선언
Function GetOrdinal ( _
    name As String _
) As Integer
‘사용 방법
Dim instance As IDataRecord
Dim name As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(name)

int GetOrdinal (
    string name
)

int GetOrdinal (
    String^ name
)

int GetOrdinal (
    String name
)

function GetOrdinal (
    name : String
) : int

매개 변수

  • name
    찾을 필드의 이름입니다.

반환 값

이름이 지정된 필드의 인덱스를 반환합니다.

설명

GetOrdinal은 먼저 대/소문자를 구분하여 조회합니다. 실패하면, 두 번째로 대/소문자를 구분하지 않고 검색합니다.

GetOrdinal은 가나 전자/반자를 구분하지 않습니다.

서수 기반 조회가 명명된 조회보다 효율적이기 때문에 루프 내에서 GetOrdinal을 호출하는 것은 비효율적입니다. GetOrdinal을 한 번 호출하고 그 결과를 루프 내에서 사용할 정수 변수에 할당함으로써 시간을 절약할 수 있습니다.

예제

다음 예제에서는 상속된 GetOrdinal 메서드를 사용하는 방법을 보여 줍니다.

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

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

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

IDataRecord 인터페이스
IDataRecord 멤버
System.Data 네임스페이스