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