DataTableReader.GetName メソッド

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

DataTableReader.GetName メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した列の値を String として取得します。

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

Visual Basic (宣言)

Public Overrides Function
 GetName ( _
    ordinal As Integer _
) As String

Visual Basic (使用法)

Dim instance As DataTableReader
Dim ordinal As Integer
Dim returnValue As String

returnValue = instance.GetName(ordinal)

C#

public override string GetName (
    int ordinal
)

C++

public:
virtual String^ GetName (
    int ordinal
) override

J#

public String GetName (
    int ordinal
)

JScript

public override function GetName (
    ordinal : int
) : String

パラメータ

ordinal

列の 0 から始まる序数。

戻り値
指定した列の名前。

例外

例外の種類	条件
ArgumentOutOfRangeException	渡されたインデックスが 0 から FieldCount - 1 の範囲にありません。
InvalidOperationException	閉じている DataTableReader の列を読み取るかアクセスしようとしました。

解説

GetName メソッドと GetOrdinal メソッドにより、反転機能が実現されます。つまり、GetName を呼び出して返された値に対して GetOrdinal を呼び出すと、GetName に渡された元のパラメータが返されます。この 2 つのプロシージャを逆の順序で呼び出しても同様の結果になります。

使用例

指定した DataTableReader 内のすべての列の名前および列の序数位置を一覧表示するプロシージャを使用した簡単な例を次に示します。

Visual Basic

Private Sub DisplayColumnNames(ByVal
 reader As DataTableReader)
   ' Given a DataTableReader, display column names.
   For i As Integer = 0
 To reader.FieldCount - 1
      Console.WriteLine("{0}: {1}", i, reader.GetName(i))
   Next
End Sub

C#

private static void DisplayColumnNames(DataTableReader
 reader)
{
    // Given a DataTableReader, display column names.
    for (int i = 0; i < reader.FieldCount;
 i++) 
    {
        Console.WriteLine("{0}: {1}", i, reader.GetName(i));
    }
}

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

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