Поделиться через


_Table.GetArray(Int32) Метод

Определение

Получает двумерный массив, содержащий набор значений строк и столбцов из Table.

public:
 System::Object ^ GetArray(int MaxRows);
public object GetArray (int MaxRows);
Public Function GetArray (MaxRows As Integer) As Object

Параметры

MaxRows
Int32

Задает максимальное количество строк, возвращаемых из таблицы.

Возвращаемое значение

Значение объекта, представляющее собой двумерный массив, представляющий набор значений строк и столбцов из таблицы. Массив отсчитывается от нуля; индекс массива (i, j) индексирует i-й столбец и j-й строку в массиве. Столбцы в массиве соответствуют столбцам в таблице, а строки в массиве соответствуют строкам в таблице. Число строк в возвращаемом массиве — это меньшее значение MaxRows и фактическое количество строк в таблице.

Комментарии

Метод GetArray предлагает концептуально простое средство получения значений из таблицы путем копирования всех или части данных в таблице (на основе текущей строки) в массив и индексирования в массив.

GetArray всегда начинается с текущей строки таблицы. Он возвращает массив с числом строк, если в таблице есть по крайней мере MaxRows количество строк, начиная с MaxRows текущей позиции. Если MaxRows значение не больше, чем общее число строк в таблице, и в таблице меньше, чем MaxRows количество элементов, начиная с текущей строки, возвращается массив, содержащий только оставшиеся строки в таблице. Если метод GetArray вызывается и не осталось строк, getArray возвращает пустой массив с нулевыми элементами.

После получения соответствующих строк из таблицы и перед ее возвратом GetArray всегда переместит текущую строку в следующую строку таблицы, если есть следующая строка. Метод GetArray(n) работает так, как будто GetNextRow() вызывается n раз.

Значения в столбцах сопоставляются со столбцами в таблице и поэтому определяются форматом имени свойства, используемого для столбца. Дополнительные сведения см. в разделе Факторы, влияющие на представление значения свойства в классах таблиц и представлений.

Применяется к