IDataRecord.GetOrdinal(String) Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Mengembalikan indeks bidang bernama.

public:
 int GetOrdinal(System::String ^ name);

public int GetOrdinal (string name);

abstract member GetOrdinal : string -> int

Public Function GetOrdinal (name As String) As Integer

Parameter

name

String

Nama bidang yang akan ditemukan.

Mengembalikan

Int32

Indeks bidang bernama.

Contoh

Contoh berikut menunjukkan cara menggunakan metode yang diwariskan GetOrdinal .

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

Keterangan

GetOrdinal melakukan pencarian peka huruf besar/kecil terlebih dahulu. Jika gagal, pencarian tidak peka huruf besar/kecil kedua akan dilakukan. GetOrdinal tidak peka lebar kana. Jika indeks bidang bernama tidak ditemukan, maka IndexOutOfRangeException akan dilemparkan.

Karena pencarian berbasis ordinal lebih efisien daripada pencarian bernama, tidak efisien untuk memanggil GetOrdinal dalam perulangan. Hemat waktu dengan memanggil GetOrdinal satu kali dan menetapkan hasilnya ke variabel bilangan bulat untuk digunakan dalam perulangan.