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 массив, длина которого превышает количество столбцов, содержащихся в результирующей строке.

Этот метод возвращает объекты DBNull для столбцов базы данных со значениями NULL.