Add(String,Boolean,WorksheetTableStyle) メソッド

特定の領域をテーブルとして書式設定し、関連する WorksheetTable をこのコレクションに追加します。

シンタックス

C#

public WorksheetTable Add( 
   string region,
   bool tableHasHeaders,
   WorksheetTableStyle tableStyle
)

パラメータ

region

テーブルとして書式設定する領域。

tableHasHeaders

この領域の一番上の行にテーブルのヘッダーが含まれているかどうかを示す値です。

tableStyle

このテーブルに適用する WorksheetTableStyle、または Workbook.DefaultTableStyle を使用する場合は null 値になります。

戻り値の型

作成された WorksheetTable は、この領域の書式設定付きテーブルを表します。

例外

例外	解説
System.InvalidOperationException	親ワークシートは子ワークブックから削除されています。
System.ArgumentNullException	region は null または空です。
System.ArgumentException	region はワークブックのセル参照モードで無効な領域アドレスです。
System.ArgumentException	指定された tableStyle は CustomTableStyles または StandardTableStyles コレクションに存在しません。
System.InvalidOperationException	この領域には、別の WorksheetTable のセルが 1 つ以上含まれています。
System.InvalidOperationException	この領域には、マルチセルの ArrayFormula が適用されるセルが 1 つ以上含まれています。
System.InvalidOperationException	この領域には、WorksheetDataTable の一部であるセルが 1 つ以上含まれています。

解説

このテーブルを作成すると、指定された tableStyle は の値に適用されます。

tableHasHeaders が True である場合、このテーブルを作成すると、列名はヘッダー行のセルから取り込まれます。False の場合、列名が生成されてヘッダー行のセルがワークシートに挿入されます。

列の名前は、親 WorksheetTable 内における一意の名前です。テーブルの作成時に同名の列が 2 つ以上存在する場合、各列を一意に識別できるように 2 番目以降の重複列名の末尾に番号が振られていきます。ヘッダー行のセルのなかに文字列以外の値を持つものがある場合、その値は文字列 (そのセルの現在の表示テキスト) に変換されます。ヘッダー行のセルに値を持たないものがある場合、それらのセルには生成された列名が与えられます。

この領域に収めきれない結合セル領域がある場合、そうしたセル領域はワークシートから除外され、結合領域のセルがすべて収まるようにテーブル領域が拡張されます。