OleDbDataReader.GetOrdinal メソッド

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

OleDbDataReader.GetOrdinal メソッド

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As OleDbDataReader
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 から始まる序数。

例外

例外の種類	条件
IndexOutOfRangeException	指定した名前が有効な列名ではありません。

解説

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 OleDbConnection(connectionString)
        Dim command As New
 OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()

        Dim customerID As Integer
 = reader.GetOrdinal("CustomerID")
        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
        End While
        reader.Close()
    End Using
End Sub

C#

public static void ReadData(string
 connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM
 Orders";
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

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

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

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

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        string x = "Provider=SQLOLEDB;Data Source=(local);Integrated
 Security=SSPI;Initial Catalog=Northwind";
        ReadData(x);
    }

    public static void ReadData(string
 connectionString)
    {
        string queryString = "SELECT DISTINCT CustomerID FROM
 Orders";
        using (OleDbConnection connection = new
 OleDbConnection(connectionString))
        {
            OleDbCommand command = new OleDbCommand(queryString,
 connection);

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

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

            while (reader.Read())
            {
                Console.WriteLine("CustomerID={0}", reader.GetString(customerID));
            }
            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、1.0

参照

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