SqlDataReader.GetValues(Object[]) 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

使用目前資料列的資料行值填入物件陣列。

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 陣列。

傳回

Int32

陣列中 Object 的執行個體數目。

實作

GetValues(Object[])

範例

下列範例示範如何使用正確大小的陣列，從所提供的 SqlDataReader 中目前資料列讀取所有值。 此外，此範例會示範如何使用可小於或大於可用資料行數目的固定大小陣列。

// using Microsoft.Data.SqlClient;
private static void TestGetValues(SqlDataReader reader)
{
    // Given a SqlDataReader, 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]);
}

備註

對於大部分的應用程式，這個方法提供有效率的方式擷取所有資料行，而不是個別擷取每個資料行。

您可以傳遞 Object 陣列，其中包含少於結果資料列中包含的資料行數目。 只有陣列保留的資料 Object 量會複製到陣列。 您也可以傳遞 Object 長度超過結果資料列中包含的資料行數目的陣列。

對於 null 資料庫資料行來說，這個方法會傳回 DBNull。