OdbcDataReader.GetOrdinal メソッド

.NET Framework クラス ライブラリ リファレンス

OdbcDataReader.GetOrdinal メソッド

列の名前を指定して、列の序数を取得します。

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetOrdinal ( _
    value As String _
) As Integer

Visual Basic (使用法)

Dim instance As OdbcDataReader
Dim value As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(value)

C#

public override int GetOrdinal (
    string value
)

C++

public:
virtual int GetOrdinal (
    String^ value
) override

J#

public int GetOrdinal (
    String value
)

JScript

public override function GetOrdinal (
    value : String
) : int

パラメータ

value

列の名前。

戻り値
列の 0 から始まる序数。

解説

GetOrdinal は、初めに大文字と小文字を区別して検索を実行します。それに失敗した場合は、大文字と小文字を区別せずに、2 回目の検索が実行されます。

GetOrdinal では、かなの全角と半角が区別されません。

序数ベースの検索は名前ベースの検索よりも効率的なため、ループ内で GetOrdinal を呼び出すことは非効率的です。代わりに、GetOrdinal を 1 回呼び出し、その結果を整数の変数に割り当てて、ループ内で使用します。

使用例

GetOrdinal メソッドを使用する方法の例を次に示します。

Visual Basic

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

C#

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();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcDataReader クラス
OdbcDataReader メンバ
System.Data.Odbc 名前空間
GetName
その他の技術情報
DataReader の使用