SqlDataReader.GetOrdinal メソッド

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

SqlDataReader.GetOrdinal メソッド

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As SqlDataReader
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

Private Sub ReadGetOrdinal(ByVal
 connectionString As String)
    Dim queryString As String
 = _
       "SELECT DISTINCT CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New
 SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call GetOrdinal and assign value to variable.
        Dim customerID As Integer
 = reader.GetOrdinal("CustomerID")

        ' Use variable with GetString inside of loop.
        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader.GetString(customerID))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

C#

private static void ReadGetOrdinal(string
 connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM
 dbo.Orders;";
    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

        SqlDataReader reader = command.ExecuteReader();

        // Call GetOrdinal and assign value to variable.
        int customerID = reader.GetOrdinal("CustomerID");

        // Use variable with GetString inside of loop.
        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

参照

関連項目
SqlDataReader クラス
SqlDataReader メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用