FormatAsTable(Boolean) メソッド

領域をテーブルとして書式設定し、関連付けられた WorksheetTable を Worksheet.Tables コレクションに追加します。

シンタックス

C#

public WorksheetTable FormatAsTable( 
   bool tableHasHeaders
)

パラメータ

tableHasHeaders

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

戻り値の型

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

例外

例外	解説
System.InvalidOperationException	この領域には、別の WorksheetTable のセルが 1 つ以上含まれています。
System.InvalidOperationException	この領域には、マルチセルの ArrayFormula が適用されるセルが 1 つ以上含まれています。
System.InvalidOperationException	この領域には、WorksheetDataTable の一部であるセルが 1 つ以上含まれています。

解説

このテーブルを作成すると、 の値に Workbook.DefaultTableStyle が適用されます。

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

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

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