DataTableReader.GetValue(Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得使用原生格式的指定資料行值。
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
以零為基底的資料行序數。
傳回
指定的資料行值。 這個方法會傳回 null 資料行的 DBNull
。
例外狀況
傳遞的索引超出 0 到 FieldCount - 1 的範圍。
嘗試從已刪除的資料列擷取資料。
嘗試在關閉的 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 值,但您不需要執行此動作。