SqlDataReader.GetOrdinal(String) Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Paket:

System.Data.SqlClient v4.8.6

Mendapatkan kolom ordinal, 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.

Penerapan

GetOrdinal(String)

Pengecualian

IndexOutOfRangeException

Nama yang ditentukan bukan nama kolom yang valid.

Contoh

Contoh berikut menunjukkan cara menggunakan GetOrdinal metode .

private static void ReadGetOrdinal(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM dbo.Orders;";
    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

        SqlDataReader reader = command.ExecuteReader();

        // Call GetOrdinal and assign value to variable.
        int customerID = reader.GetOrdinal("CustomerID");

        // Use variable with GetString inside of loop.
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
        }

        // Call Close when done reading.
        reader.Close();
    }
}

Private Sub ReadGetOrdinal(ByVal connectionString As String)
    Dim queryString As String = _
       "SELECT DISTINCT CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call GetOrdinal and assign value to variable.
        Dim customerID As Integer = reader.GetOrdinal("CustomerID")

        ' Use variable with GetString inside of loop.
        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 kedua yang tidak peka huruf besar/kecil terjadi (perbandingan yang tidak peka huruf besar/kecil dilakukan menggunakan kolate database). Hasil yang tidak terduga dapat terjadi ketika perbandingan dipengaruhi oleh aturan casing khusus budaya. Misalnya, dalam bahasa Turki, contoh berikut menghasilkan hasil yang salah karena sistem file dalam bahasa Turki tidak menggunakan aturan casing linguistik untuk huruf 'i' dalam "file". 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 sekali dan menetapkan hasilnya ke variabel bilangan bulat untuk digunakan dalam perulangan.

Lihat juga

• DataAdapters dan DataReaders (ADO.NET)
• SQL Server dan ADO.NET
• Ringkasan ADO.NET