IDataRecord.GetOrdinal メソッド

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

IDataRecord.GetOrdinal メソッド

指定したフィールドのインデックスを返します。

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

Visual Basic (宣言)

Function GetOrdinal ( _
    name As String _
) As Integer

Visual Basic (使用法)

Dim instance As IDataRecord
Dim name As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(name)

C#

int GetOrdinal (
    string name
)

C++

int GetOrdinal (
    String^ name
)

J#

int GetOrdinal (
    String name
)

JScript

function GetOrdinal (
    name : String
) : int

パラメータ

name

検索するフィールドの名前。

戻り値
指定したフィールドのインデックス。

解説

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 CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IDataRecord インターフェイス
IDataRecord メンバ
System.Data 名前空間