ListObjects.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
新しいリスト オブジェクトを作成します。 ListObject オブジェクトを返します。
public Microsoft.Office.Interop.Excel.ListObject Add(Microsoft.Office.Interop.Excel.XlListObjectSourceType SourceType = Microsoft.Office.Interop.Excel.XlListObjectSourceType.xlSrcRange, object Source, object LinkSource, Microsoft.Office.Interop.Excel.XlYesNoGuess XlListObjectHasHeaders = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlGuess, object Destination);
Public Function Add (Optional SourceType As XlListObjectSourceType = Microsoft.Office.Interop.Excel.XlListObjectSourceType.xlSrcRange, Optional Source As Object, Optional LinkSource As Object, Optional XlListObjectHasHeaders As XlYesNoGuess = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlGuess, Optional Destination As Object) As ListObject
パラメーター
- SourceType
- XlListObjectSourceType
省略可能な XlListObjectSourceType。 クエリで使用されるソースの種類を指定します。
XlListObjectSourceType 定数のいずれかを指定できます。xlSrcExternal または xlSrcRange。 省略した場合、 SourceType は既定で xlSrcRange になります。
- Source
- Object
SourceTypeが xlSrcRange の場合は省略可能です。 データ ソースを表す Range オブジェクト。 省略した場合、 Source はリスト範囲検出コードによって返される範囲を既定値で設定します。
SourceTypeが xlSrcExternal の場合は必須です。 ソースへの接続を指定する String 値の配列。Element#Contents0URL to SharePoint site 1ListName 2ViewGUID
- LinkSource
- Object
省略可能な ブール値。 外部データ ソースを ListObject オブジェクトにリンクするかどうかを指定します。
SourceTypeが xlSrcExternal の場合、既定値は True です。
SourceTypeが xlSrcRange の場合は無効です。省略しない場合はエラーを返します。
- XlListObjectHasHeaders
- XlYesNoGuess
オプションの オブジェクト。 インポートするデータに列ラベルがあるかどうかを示す XlYesNoGuess 定数。 Source が列見出しを持たない場合、自動的に生成されます。
- Destination
- Object
オプションの オブジェクト。 新しいリスト オブジェクトの左上隅の出力先として単一セル参照を指定する Range オブジェクト。
Range オブジェクトが複数のセルを参照する場合は、エラーが生成されます。
Destination 引数は、SourceType が xlSrcExternal に設定されている場合に指定する必要があります。
SourceType が xlSrcRange に設定されている場合、Destination引数は無視されます。 対象範囲は、指定した ListObjects コレクションを含むワークシート上にある必要があります。 新しい列は、新しいリストに合わせて Destination に挿入されます。 したがって、既存のデータは上書きされません。
返品
注釈
リストに見出しがあり、セルの最初の行が文字列以外である場合、セルの最初の行は文字列に変換されます。 変換はセル内に表示されている文字列に基づいて実行されます。 たとえば、ロケールによって決まる日付型 ( Date ) の日付の値は、現在のシステム ロケールに応じて、リストへの変換結果が異なることがあります。 さらに、見出し行の 2 つのセル内に同じ文字列が表示されている場合、各列の見出しが一意になるよう、整数型 ( Integer ) の連番が添えられます。