DataTableReader.GetValue メソッド

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

DataTableReader.GetValue メソッド

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

指定した列の値をネイティブ形式で取得します。

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

Visual Basic (宣言)

Public Overrides Function
 GetValue ( _
    ordinal As Integer _
) As Object

Visual Basic (使用法)

Dim instance As DataTableReader
Dim ordinal As Integer
Dim returnValue As Object

returnValue = instance.GetValue(ordinal)

C#

public override Object GetValue (
    int ordinal
)

C++

public:
virtual Object^ GetValue (
    int ordinal
) override

J#

public Object GetValue (
    int ordinal
)

JScript

public override function GetValue (
    ordinal : int
) : Object

パラメータ

ordinal

列の 0 から始まる序数。

戻り値
指定した列の値。null 列の場合は、DBNull が返されます。

例外

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

解説

このメソッドを呼び出す前に IsDbNull を呼び出すことで null 値があるかどうかを確認できますが、その必要はありません。

使用例

DataTableReader の現在の行ですべての列を反復処理し、各列の内容と列名を表示する例を次に示します。一般的に、DataTableReader で取得した行内のすべての列を操作する場合には、GetValues メソッドの方が効率的なため、こちらを使用することをお勧めします。

Visual Basic

Private Sub GetAllValues(ByVal
 reader As DataTableReader)

   ' Given a DataTableReader, retrieve the value of 
   ' each column, and display the name, value, and type.
   ' Make sure you've called reader.Read at least once before
   ' calling this procedure.
   ' Loop through all the columns.
   Dim value As Object
   For i As Integer = 0
 To reader.FieldCount - 1
      If reader.IsDBNull(i) Then
         value = "<NULL>"
      Else
         value = reader.GetValue(i)
      End If
      Console.WriteLine("{0}: {1} ({2})", reader.GetName(i),
 _
         value, reader.GetFieldType(i).Name)
   Next
End Sub

C#

private static void GetAllValues(DataTableReader
 reader)
{
    // Given a DataTableReader, retrieve the value of 
    // each column, and display the name, value, and type.
    // Make sure you have called reader.Read at least once before
    // calling this procedure.

    // Loop through all the columns.
    object value = null;
    for (int i = 0; i < reader.FieldCount;
 i++)
    {
        if (reader.IsDBNull(i))
        {
            value = "<NULL>";
        }
        else
        {
            value = reader.GetValue(i);
        }
        Console.WriteLine("{0}: {1} ({2})", reader.GetName(i), 
            value, reader.GetFieldType(i).Name);
    }
}

プラットフォーム

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 名前空間