DataTableReader.GetValue(Int32) メソッド

定義

名前空間:

System.Data

アセンブリ:

System.Data.dll

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

public:
 override System::Object ^ GetValue(int ordinal);

public override object GetValue(int ordinal);

override this.GetValue : int -> obj

Public Overrides Function GetValue (ordinal As Integer) As Object

パラメーター

ordinal

Int32

0 から始まる列の序数。

返品

Object

指定した列の値。 このメソッドは、null 列の DBNull を返します。

例外

ArgumentOutOfRangeException

渡されたインデックスが 0 から FieldCount - 1 の範囲外でした。

DeletedRowInaccessibleException

削除された行からデータを取得しようとしました。

InvalidOperationException

閉じた DataTableReader 内の列の読み取りまたはアクセスが試行されました。

例

次の例では、 DataTableReaderの現在の行内のすべての列を反復処理し、各列の内容と列名を表示します。 一般に、 DataTableReaderによって取得された行内のすべての列を操作する場合は、代わりに GetValues メソッドを使用することを検討してください。これは、より効率的であるためです。

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);
    }
}

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

注釈

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