OdbcDataReader.GetOrdinal メソッド

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

Public Overridable Function GetOrdinal( _
   ByVal value As String _) As Integer Implements IDataRecord.GetOrdinal
[C#]
public virtual int GetOrdinal(stringvalue);
[C++]
public: virtual int GetOrdinal(String* value);
[JScript]
public function GetOrdinal(
   value : String) : int;

パラメータ

• value
  列の名前。

戻り値

列の 0 から始まる序数。

実装

IDataRecord.GetOrdinal

解説

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

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

名前を基にした検索よりも、序数を基にした検索の方が効率的です。ループ内で GetOrdinal を呼び出すのは効率的ではありません。代わりに、 GetOrdinal を 1 回呼び出し、その結果を整数の変数に割り当てて、ループ内で使用します。

使用例

[Visual Basic, C#, C++] GetOrdinal メソッドを使用する方法の例を次に示します。

 
Public Sub ReadMyData(myConnString As String)

  Dim mySelectQuery As String = "SELECT OrderID, CustomerID FROM Orders"
  Dim myConnection As New OdbcConnection(myConnString)
  Dim myCommand As New OdbcCommand(mySelectQuery, myConnection)

  myConnection.Open()

  Dim myReader As OdbcDataReader = myCommand.ExecuteReader()

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

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

  myReader.Close()
  myConnection.Close()
End Sub

[C#] 
public void ReadMyData(string myConnString)
{
    string mySelectQuery = "SELECT OrderID, CustomerID FROM Orders";
    OdbcConnection myConnection = new OdbcConnection(myConnString);
    OdbcCommand myCommand = new OdbcCommand(mySelectQuery,myConnection);

    myConnection.Open();
    OdbcDataReader myReader = myCommand.ExecuteReader();

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

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

    myReader.Close();
    myConnection.Close();
}

[C++] 
public:
    void ReadMyData(String* myConnString)
    {
        String* mySelectQuery = S"SELECT OrderID, CustomerID FROM Orders";
        OdbcConnection* myConnection = new OdbcConnection(myConnString);
        OdbcCommand* myCommand = new OdbcCommand(mySelectQuery, myConnection);

        myConnection->Open();
        OdbcDataReader* myReader = myCommand->ExecuteReader();

        int custIdCol = myReader->GetOrdinal(S"CustomerID");

        while (myReader->Read())
            Console::WriteLine(S"CustomerID = {0}", myReader->GetString(custIdCol));

        myReader->Close();
        myConnection->Close();
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

OdbcDataReader クラス | OdbcDataReader メンバ | System.Data.Odbc 名前空間 | GetName