OracleDataReader.GetOrdinal メソッド

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

OracleDataReader.GetOrdinal メソッド

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As OracleDataReader
Dim name As String
Dim returnValue As Integer

returnValue = instance.GetOrdinal(name)

C#

public override int GetOrdinal (
    string name
)

C++

public:
virtual int GetOrdinal (
    String^ name
) override

J#

public int GetOrdinal (
    String name
)

JScript

public override function GetOrdinal (
    name : String
) : int

パラメータ

name

列の名前。

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

解説

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

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

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

使用例

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

[Visual Basic]

Public Sub ReadOracleData(ByVal connectionString As String)

    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Dim connection As New OracleConnection(connectionString)
    Dim command As New OracleCommand(queryString, connectionString)

    connection.Open()

    Dim reader As OracleDataReader = command.ExecuteReader()

    Dim custIdCol As Integer = reader.GetOrdinal("CustomerID")

    Do While reader.Read()
        Console.WriteLine("CustomerID = {0}", reader.GetString(custIdCol))
    Loop

    reader.Close()
    connection.Close()
End Sub

[C#]

public void ReadOracleData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    OracleConnection connection = new OracleConnection(connectionString);
    OracleCommand command = new OracleCommand(queryString,connection);

    connection.Open();
    OracleDataReader reader = command.ExecuteReader();

    int custIdCol = reader.GetOrdinal("CustomerID");

    while (reader.Read())
        Console.WriteLine("CustomerID = {0}", reader.GetString(custIdCol));

    reader.Close();
    connection.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

参照

関連項目
OracleDataReader クラス
OracleDataReader メンバ
System.Data.OracleClient 名前空間