DataTableReader.GetValue(Int32) DataTableReader.GetValue(Int32) DataTableReader.GetValue(Int32) DataTableReader.GetValue(Int32) Method

定義

指定した列の値をネイティブ形式で取得します。Gets the value of the specified column in its native format.

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 Int32 Int32 Int32

列の 0 から始まる序数。The zero-based column ordinal

戻り値

指定された列の値。The value of the specified column. null 列の場合は、DBNull が返されます。This method returns DBNull for null columns.

例外

渡されたインデックスが 0 から FieldCount - 1 の範囲にありません。The index passed was outside the range of 0 to FieldCount - 1.

削除した行からデータを取得しようとしました。An attempt was made to retrieve data from a deleted row.

閉じている DataTableReader の列を読み取るかアクセスしようとしました。An attempt was made to read or access columns in a closed DataTableReader .

次の例では、の現在の行DataTableReaderに含まれるすべての列を反復処理し、各列の内容と列名を表示します。The following example iterates through all the columns within the current row in a DataTableReader, displaying the contents of each column and the column name. 一般に、によってDataTableReader取得される行内のすべての列を使用する場合は、代わりにGetValuesメソッドを使用することをお勧めします。これは、より効率的な方法です。Generally, if your intent is to work with all the columns within a row retrieved by a DataTableReader, consider using the GetValues method instead, because it is more efficient.

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 値があるかどうかを確認することもできますが、この操作は必要ありません。Although you can call IsDBNull to see if there are null values before calling this method, you do not have to do this.

適用対象