會建立新的清單物件。
語法
運算式。新增 (SourceType、 Source、 LinkSource、 XlListObjectHasHeaders、 Destination、 TableStyleName)
表達 代表 ListObjects 物件的 變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| SourceType | 選用 | XlListObjectSourceType | 會指出查詢的來源類型。 |
| Source | Optional | Variant | 當SourceType = xlSrcRange：代表資料來源的Range物件。 如果省略， Source 會預設為清單範圍偵測程式碼所傳回的範圍。 當SourceType = xlSrcExternal：指定來源連接的String值陣列，其中包含下列元素：
當SourceType = xlSrcModel：接受 WorkbookConnection 物件時 (請參閱TableObject，例如) 。 |
| LinkSource | 選用 | 布林值 | 指出外部資料源是否要連結至 ListObject 物件。 如果 SourceType 為 xlSrcExternal，則預設值為 True。 如果 SourceType 為 xlSrcRange則無效，如果未省略，則會傳回錯誤。 |
| XlListObjectHasHeaders | 選用 | Variant | XlYesNoGuess常數，指出要匯入的資料是否具有資料行標籤。 如果 Source 不包含標題，則 Excel 將會自動產生標題。 預設值： xlGuess。 |
| 目的地 | 選用 | Variant |
Range物件，指定單一儲存格參考做為新清單物件左上角的目的地。 如果 Range 物件參考多個儲存格，則會產生錯誤。 當SourceType設定為xlSrcExternal時，必須指定Destination引數。 如果SourceType設定為xlSrcRange，則會忽略Destination引數。 目的範圍必須位於包含expression所指定之 ListObjects集合的工作表上。 新的資料行會插入 目的地以符合 新清單。 因此，不會覆寫現有的資料。 |
| TableStyleName | 選用 | 字串 | TableStyle的名稱;例如 「TableStyleLight1」。 |
傳回值
代表新清單物件的 ListObject 物件。
註解
當清單具有標頭時，如果儲存格的第一列尚未設定為 文字，則會轉換成 Text。 轉換會以儲存格的可見文字為基礎。 這表示，如果有日期值的 日期 格式會隨著地區設定而變更，則根據目前的系統地區設定，轉換為清單可能會產生不同的結果。 此外，如果標頭資料列中有兩個具有相同可見文字的儲存格 ，則會 附加累加整數，讓每個資料行標頭成為唯一的。
範例
下列範例會根據來自 Microsoft SharePoint Foundation 網站的資料，將新的 ListObject 物件新增至預設 的 ListObjects 集合，並將清單放在活頁簿第一張工作表的儲存格 A1 中。
注意事項
下列程式碼範例假設您將取代變數 strServerName 和 strListGUID 中的有效伺服器名稱和清單 GUID。 此外，伺服器名稱後面必須接著 "/_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 支援與意見反應。