OleDbDataReader.GetOrdinal(String) Metode

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-preview.3.24172.9

Sumber:

OleDbDataReader.cs

Mendapatkan ordinal kolom, dengan nama kolom.

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

Parameter

name

String

Nama kolom.

Mengembalikan

Int32

Ordinal kolom berbasis nol.

Pengecualian

IndexOutOfRangeException

Nama yang ditentukan bukan nama kolom yang valid.

Contoh

Contoh berikut menunjukkan cara menggunakan GetOrdinal metode .

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

Keterangan

GetOrdinal melakukan pencarian peka huruf besar/kecil terlebih dahulu. Jika gagal, pencarian tidak peka huruf besar/kecil kedua akan dilakukan. Metode ini memberikan IndexOutOfRange pengecualian jika ordinal kolom berbasis nol tidak ditemukan.

GetOrdinal tidak peka lebar kana.

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.

Lihat juga

• DataAdapters dan DataReaders