OdbcDataReader.GetOrdinal(String) 方法

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v11.0.0-preview.4.26230.115

來源:

OdbcDataReader.cs

取得資料列序數，指定資料行的名稱。

public:
 override int GetOrdinal(System::String ^ value);

public override int GetOrdinal(string value);

override this.GetOrdinal : string -> int

Public Overrides Function GetOrdinal (value As String) As Integer

參數

value

String

欄位名稱。

傳回

Int32

零基列序數。

範例

以下範例示範如何使用此 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

備註

GetOrdinal 先執行大小寫區分查詢。 若失敗，則進行第二次不區寫搜尋。 若找不到以零為基礎的列序數，該方法會 IndexOutOfRange 拋出例外。

GetOrdinal 假名寬度不敏感。

由於基於序數的查詢比命名查詢更有效率，因此在迴圈內呼叫 GetOrdinal 效率較低。 相反地，先呼叫 GetOrdinal 一次，然後將結果指派到一個整數變數，以便在迴圈中使用。

另請參閱

• GetName(Int32)
• DataAdapter 和 DataReader