SqlDataReader.GetValues(Object[]) 메서드

정의

현재 행의 열 값으로 개체 배열을 채웁니다.Populates an array of objects with the column values of the current row.

public:
 virtual int GetValues(cli::array <System::Object ^> ^ values);
public int GetValues (object[] values);
abstract member GetValues : obj[] -> int
override this.GetValues : obj[] -> int
Public Function GetValues (values As Object()) As Integer

매개 변수

values
Object[]

특성 열을 복사해 올 Object의 배열입니다.An array of Object into which to copy the attribute columns.

반환

배열에 포함된 Object 인스턴스의 수입니다.The number of instances of Object in the array.

구현

예제

다음 예제에서는 올바른 크기의 배열을 사용 하 여 제공 된 SqlDataReader의 현재 행에서 모든 값을 읽는 방법을 보여 줍니다.The following example demonstrates using a correctly sized array to read all values from the current row in the supplied SqlDataReader. 또한 샘플 작은 또는 사용할 수 있는 열 개수 보다 클 수 있는 고정 크기 배열을 사용 하 여 보여 줍니다.In addition, the sample demonstrates using a fixed-sized array that could be either smaller or larger than the number of available columns.

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]);
}
Private Sub TestGetValues(ByVal reader As SqlDataReader)

    ' 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.
    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

설명

이 메서드는 대부분의 애플리케이션에 대 한 각 열을 개별적으로 검색 하는 대신 모든 열을 검색는 효율적인 방법을 제공 합니다.For most applications, this method provides an efficient means for retrieving all columns, instead of retrieving each column individually.

결과 행에 포함 된 열 수를 포함 하는 Object 배열을 전달할 수 있습니다.You can pass an Object array that contains fewer than the number of columns contained in the resulting row. Object 배열이 보유 하 고 있는 데이터의 양만 배열에 복사 됩니다.Only the amount of data the Object array holds is copied to the array. 길이가 결과 행에 포함 된 열 수보다 많은 Object 배열을 전달할 수도 있습니다.You can also pass an Object array whose length is more than the number of columns contained in the resulting row.

이 메서드는 null 데이터베이스 열에 대해서는 DBNull을 반환합니다.This method returns DBNull for null database columns.

적용 대상

추가 정보