Share via


ListObject.Delete 方法

刪除動態建立的 ListObject 控制項,從工作表清除儲存格的資料,並從 ControlCollection 移除這個控制項。

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

語法

'宣告
Sub Delete
void Delete()

備註

這個方法應該只與執行階段中以程式設計方式建立的 ListObject 控制項一起使用。 如果您在 ListObject 上呼叫這個方法且此物件是在設計階段加入至文件,則會擲回例外狀況。

如果清單物件連結至 SharePoint 網站,刪除物件不會影響執行 Windows SharePoint Services 之伺服器上的資料。 任何未經認可的本機清單物件變更,不會傳送至 SharePoint 清單。 (不會有警告告知這些未經認可的變更將會遺失)。

範例

下列程式碼範例會在目前的工作表上建立 ListObject,然後顯示訊息方塊,詢問使用者是否要刪除這個 ListObject。 如果使用者同意刪除,則會呼叫 Delete 方法以移除這個 ListObject

這是示範文件層級自訂的範例。

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

        If DialogResult.Yes = MessageBox.Show("Delete the ListObject?", _
            "Test", MessageBoxButtons.YesNo) Then
            List1.Delete()
        End If

    End Sub

private void ListObject_Delete()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "D4"], "list1");

    if (DialogResult.Yes == MessageBox.Show("Delete the ListObject?",
        "Test", MessageBoxButtons.YesNo))
    {
        list1.Delete();
    }
}

.NET Framework 安全性

請參閱

參考

ListObject 介面

Microsoft.Office.Tools.Excel 命名空間