_Table.GetArray(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
から行と列の値のセットを含む 2 次元配列を取得します Table。
public:
System::Object ^ GetArray(int MaxRows);public object GetArray (int MaxRows);Public Function GetArray (MaxRows As Integer) As Objectパラメーター
- MaxRows
- Int32
テーブル から取得する行の最大数を指定します。
戻り値
Table の行と列の値のセットを表す 2 次元配列である Object 値。 配列は 0 から始まります。配列インデックス (i, j) は、配列内の i 番目の列と j 番目の行にインデックスを作成します。 配列内の列は Table 内の列に対応し、配列内の行は Table 内の行に対応 します。 返される配列内の行数は、 の値 MaxRows が小さく、Table 内の実際の行数 です。
注釈
GetArray メソッドは、概念的には単純な (現在の行に基づいて) テーブル 内のデータのすべてまたは一部を配列にコピーし、配列にインデックスを テーブル から値を取得する手段を提供します。
GetArray は、常に、 テーブル の現在の行から開始します。 現在の位置から始まるテーブル内の行数が少なくともMaxRows存在する場合は、行数の配列MaxRowsを返します。 が Table 内の行の合計数より大きくなく、現在の行から始まる Table 内の要素の数よりもMaxRows少ない場合MaxRowsは、Table 内の残りの行のみを含む配列が返されます。 GetArray を呼び出したとき、残りの行がない場合は、 GetArray は 0 個の要素に空の配列を返します。
Table から適切な行を取得し、処理を終了する前に、GetArray は常に現在の行の位置を Table の次の行に移動します (次の行がある場合)。 GetArray(n) は、n 回呼び出されたかのように GetNextRow() 動作します。
列の値は、 テーブル 内の列にマップし、ため、列で使用されるプロパティ名の形式によって決まります。 詳細については、「テーブルクラスとビュークラスのプロパティ値表現に影響を与える要因」を参照してください。