OdbcDataReader.GetOrdinal(String) メソッド

定義

名前空間:

System.Data.Odbc

アセンブリ:

System.Data.Odbc.dll

パッケージ:

System.Data.Odbc v8.0.0

ソース:

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

0 から始まる列序数。

例

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 は、まず大文字と小文字を区別して参照を実行します。 失敗した場合、次に大文字と小文字を区別せずに検索が行われます。 0 から始まる列の序数が見つからない場合、メソッドは例外をスロー IndexOutOfRange します。

GetOrdinal では、カタカナの全角と半角が区別されません。

序数に基づく参照は名前による参照よりも効率的であるため、ループ内で GetOrdinal を呼び出すのは非効率的です。 代わりに、1 回呼び出 GetOrdinal し、ループ内で使用する整数変数に結果を割り当てます。

こちらもご覧ください

• GetName(Int32)
• DataAdapter と DataReader