DataTableReader.GetValues(Object[]) 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

DataTableReader.cs

使用当前行的列值来填充对象数组。

public:
 override int GetValues(cli::array <System::Object ^> ^ values);

public override int GetValues (object[] values);

override this.GetValues : obj[] -> int

Public Overrides Function GetValues (values As Object()) As Integer

参数

values

Object[]

要将 Object 中的列值复制到其中的 DataTableReader 数组。

返回

Int32

复制到数组中的列值个数。

例外

ArgumentOutOfRangeException

传递的索引超出了 0 到 FieldCount -1 的范围。

DeletedRowInaccessibleException

尝试从已删除的行中检索数据。

InvalidOperationException

尝试读取或访问已关闭 DataTableReader 中的列。

示例

以下示例演示如何使用大小正确的数组从提供的 DataTableReader中的当前行读取所有值。 此外，此示例还演示了使用固定大小的数组，该数组可能小于或大于可用列数。

private static void TestGetValues(DataTableReader reader)
{
    // Given a DataTableReader, use the GetValues
    // method to retrieve a full row of data.
    // Test the GetValues method, passing in an array large
    // enough for all the columns.
    Object[] values = new Object[reader.FieldCount];
    int fieldCount = reader.GetValues(values);

    Console.WriteLine("reader.GetValues retrieved {0} columns.",
        fieldCount);
    for (int i = 0; i < fieldCount; i++)
        Console.WriteLine(values[i]);

    Console.WriteLine();

    // Now repeat, using an array that may contain a different
    // number of columns than the original data. This should work correctly,
    // whether the size of the array is larger or smaller than
    // the number of columns.

    // Attempt to retrieve three columns of data.
    values = new Object[3];
    fieldCount = reader.GetValues(values);
    Console.WriteLine("reader.GetValues retrieved {0} columns.",
        fieldCount);
    for (int i = 0; i < fieldCount; i++)
        Console.WriteLine(values[i]);
}

Private Sub TestGetValues(ByVal reader As DataTableReader)

    ' Given a DataTableReader, use the GetValues
    ' method to retrieve a full row of data.

    ' Test the GetValues method, passing in an array large
    ' enough for all the columns.
    Dim values(reader.FieldCount - 1) As Object
    Dim fieldCount As Integer = reader.GetValues(values)
    Console.WriteLine("reader.GetValues retrieved {0} columns.", _
         fieldCount)
    For i As Integer = 0 To fieldCount - 1
        Console.WriteLine(values(i))
    Next

    Console.WriteLine()

    ' Now repeat, using an array that may contain a different 
    ' number of columns than the original data. This should work correctly,
    ' whether the size of the array is larger or smaller than 
    ' the number of columns.

    ' Attempt to retrieve three columns of data.
    ReDim values(2)
    fieldCount = reader.GetValues(values)
    Console.WriteLine("reader.GetValues retrieved {0} columns.", _
         fieldCount)
    For i As Integer = 0 To fieldCount - 1
        Console.WriteLine(values(i))
    Next
End Sub

注解

对于大多数应用程序，此方法提供了检索所有列的有效方法，而不是单独检索每个列。 如果打算从 中的 DataTableReader行中检索所有列值， 方法 GetValues 将提供最有效的解决方案。

可以传递包含 Object 少于结果行中包含的列数的数组。 只有数组可以保存的数据 Object 量才会复制到数组。 还可以传递其 Object 长度大于结果行中包含的列数的数组，在这种情况下，其他数组元素通过方法调用保持不变。

此方法将放置在 DBNull null 列的输出数组中。