ListObjects.Add メソッド (Excel)

新しいリスト オブジェクトを作成します。

構文

Add (SourceType, Source, LinkSource, XlListObjectHasHeaders, Destination, TableStyleName)

ListObjects オブジェクトを表す変数

パラメーター

名前 必須 / オプション データ型 説明
SourceType 省略可能 XlListObjectSourceType クエリで使用されるソースの種類を指定します。
Source Optional バリアント型 SourceTypexlSrcRange = : データ ソースを 表す Range オブジェクト。 省略すると 、Source は 既定でリスト範囲検出コードによって返される範囲になります。

SourceTypexlSrcExternal = : ソースへの接続を指定する String 値の配列で、次の要素が含まれます。
  • 0 - SharePoint サイトの URL
  • 1 - ListName
  • 2 - ViewGUID
SourceTypexlSrcQuery = : ODBC または OLEDB 接続文字列を受け入れる場合 (xlSrcExternal でも動作します)。

SourceTypexlSrcModel = : WorkbookConnection オブジェクトを受け入れる場合 (たとえば、TableObject を参照してください)。
LinkSource 省略可能 Boolean 外部データ ソースを ListObject オブジェクトにリンクするかどうかを指定します。 SourceType が xlSrcExternal の場合、 既定値は True ですSourceType が xlSrcRange の場合は 無効で、省略しない場合はエラーを返します。
XlListObjectHasHeaders 省略可能 バリアント型 インポートするデータに列ラベルが含まれたかどうかを示す XlYesNoGuess 定数。 Source に ヘッダー が含まれている場合、Excelヘッダーが自動的に生成されます。 既定値: xlGuess。
宛先 省略可能 バリアント型 しい リスト オブジェクトの左上隅の移動先として単一セル参照を指定する Range オブジェクト。 Range オブジェクトが複数のセルを参照する場合は、エラーが生成されます。

SourceType が xlSrcExternal に設定されている場合 、Destination 引数を指定する必要があります。 SourceType が xlSrcRange に設定されている場合 、Destination 引数は無視されます。

変換先の範囲は、式で指定された ListObjects コレクションを含むワークシート上にある必要 があります。 新しい列は、新しいリストに合わせて Destination に挿入されます。 したがって、既存のデータは上書きされません。
TableStyleName 省略可能 String TableStyle の名前。たとえば"TableStyleLight1"。

戻り値

しいリスト オブジェクトを表す ListObject オブジェクト。

注釈

リストに見出しがあり、セルの最初の行が文字列以外である場合、セルの最初の行は 文字列 に変換されます。 変換はセル内に表示されている文字列に基づいて実行されます。 たとえば、ロケールによって決まる日付型 ( Date ) の日付の値は、現在のシステム ロケールに応じて、リストへの変換結果が異なることがあります。 さらに、見出し行の 2 つのセル内に同じ文字列が表示されている場合、各列の見出しが一意になるよう、整数型 (Integer) の連番が添えられます。

次の使用例は、Microsoft SharePoint Foundation サイトのデータに基づいて新しい ListObject オブジェクトを既定の ListObjects コレクションに追加し、ブックの最初のワークシートのセル A1 にリストを置きます。

注意

次のコード例では、変数内の有効なサーバー名とリスト GUID を置き換える必要がありますstrServerName``strListGUID。 さらに、サーバー名の後に続く必要 "/_vti_bin" (strListName) があります。またはサンプルが機能しません。

Set objListObject = ActiveWorkbook.Worksheets(1).ListObjects.Add(SourceType:= xlSrcExternal, _ 
Source:= Array(strServerName, strListName, strListGUID), LinkSource:=True, _ 
XlListObjectHasHeaders:=xlGuess, Destination:=Range("A1")), 
TableStyleName:=xlGuess, Destination:=Range("A10")) 

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。