共用方式為

ControlCollection.AddListObject 方法 (Range, String)

  • 發行項

將新的 ListObject 控制項加入至工作表中指定的範圍。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject

ListObject AddListObject(
    Range range,
    string name
)

參數

傳回值

型別：Microsoft.Office.Tools.Excel.ListObject
已加入至 ControlCollection 執行個體的 ListObject 控制項。

例外狀況

例外狀況 條件
ArgumentNullException

名稱或範圍引數為 nullNull 參照 (即 Visual Basic 中的 Nothing)，或者名稱引數的長度為 0。
ControlNameAlreadyExistsException

具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。
InvalidRangeException

指定的範圍無效。 無法使用多區域範圍。 範圍必須放在和 ControlCollection 執行個體相同的工作表上。

備註

AddListObject 方法可以用來將 ListObject 控制項加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 ListObject 控制項，請使用 Remove 方法。

範例

下列程式碼範例會將 ListObject 控制項加入至工作表的頂端，然後顯示訊息方塊，指出 ListObject 中的列數。

Private Sub ExcelAddListObject()
    Dim List1 As Microsoft.Office.Tools.Excel. _
        ListObject = Me.Controls.AddListObject( _
        Me.Range("A1", "C5"), "List1")

    MessageBox.Show("The list object has " _
        & List1.Range.Rows.Count.ToString() + " rows.")

End Sub

private void ExcelAddListObject()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "C5"], 
        "list1");
    MessageBox.Show("The list object has " + 
        list1.Range.Rows.Count.ToString() + " rows.");
}

.NET Framework 安全性

請參閱

參考

ControlCollection 介面

AddListObject 多載

Microsoft.Office.Tools.Excel 命名空間