Excel.Interfaces.TableRowCollectionLoadOptions interface
表の一部であるすべての行のコレクションを表します。
範囲または列とは異なり、新しい行または列の前に追加された場合に調整されます。 TableRow
オブジェクトはテーブル行の物理的な場所を表しますが、データは表しません。 つまり、データが並べ替えられた場合、または新しい行が追加された場合、テーブル行は作成されたインデックスを指し続けます。
注釈
プロパティ
$all | 読み込みオプションに |
index | コレクション内の各項目について: テーブルの行コレクション内の行のインデックス番号を返します。 0 を起点とする番号になります。 |
values | コレクション内の各項目について: 指定した範囲の生の値を表します。 返されるデータは、文字列、数値、またはブール値のいずれかです。 エラーが含まれているセルは、エラー文字列を返します。 返される値が正符号 ("+")、マイナス ("-")、または等号 ("=") で始まる場合、Excel はこの値を数式として解釈します。 |
values |
コレクション内の各項目の場合: このテーブル行のセル内の値の JSON 表現。
|
values |
コレクション内の各項目の場合: このテーブル行のセル内の値の JSON 表現。
|
プロパティの詳細
$all
読み込みオプションに $all
を指定すると、すべてのスカラー プロパティ ( Range.address
など) が読み込まれますが、ナビゲーション プロパティ ( Range.format.fill.color
など) は読み込まれません。
$all?: boolean;
プロパティ値
boolean
index
コレクション内の各項目について: テーブルの行コレクション内の行のインデックス番号を返します。 0 を起点とする番号になります。
index?: boolean;
プロパティ値
boolean
注釈
values
コレクション内の各項目について: 指定した範囲の生の値を表します。 返されるデータは、文字列、数値、またはブール値のいずれかです。 エラーが含まれているセルは、エラー文字列を返します。 返される値が正符号 ("+")、マイナス ("-")、または等号 ("=") で始まる場合、Excel はこの値を数式として解釈します。
values?: boolean;
プロパティ値
boolean
注釈
valuesAsJson
コレクション内の各項目の場合: このテーブル行のセル内の値の JSON 表現。
TableRow.values
とは異なり、TableRow.valuesAsJson
ではセルに含めることができるすべてのデータ型がサポートされます。 たとえば、標準のブール値、数値、および文字列値に加えて、書式設定された数値と Web イメージが含まれます。 この API から返されるデータは、常に en-US ロケールと一致します。 ユーザーの表示ロケールでデータを取得するには、 TableRow.valuesAsJsonLocal
を使用します。
valuesAsJson?: boolean;
プロパティ値
boolean
注釈
valuesAsJsonLocal
コレクション内の各項目の場合: このテーブル行のセル内の値の JSON 表現。
TableRow.values
とは異なり、TableRow.valuesAsJsonLocal
ではセルに含めることができるすべてのデータ型がサポートされます。 たとえば、標準のブール値、数値、および文字列値に加えて、書式設定された数値と Web イメージが含まれます。 この API から返されるデータは、常にユーザーの表示ロケールと一致します。 ロケールに依存しないデータを取得するには、 TableRow.valuesAsJson
を使用します。
valuesAsJsonLocal?: boolean;
プロパティ値
boolean
注釈
Office Add-ins