ListObject.Delete-Methode

Artikel
08/10/2011

Löscht ein dynamisch erstelltes ListObject-Steuerelement, löscht die Zellendaten aus dem Arbeitsblatt und entfernt das Steuerelement aus der ControlCollection.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Sub Delete

void Delete()

Hinweise

Diese Methode darf nur mit einem ListObject-Steuerelement verwendet werden, das zur Laufzeit programmgesteuert erstellt wird. Eine Ausnahme wird ausgelöst, wenn Sie diese Methode für ein ListObject aufrufen, das dem Dokument zur Entwurfszeit hinzugefügt wurde.

Wenn das Listenobjekt mit einer SharePoint-Website verknüpft ist, hat das Löschen dieses Objekts keine Auswirkungen auf die Daten, die sich auf dem Server befinden, auf dem Windows SharePoint Services ausgeführt werden. Sämtliche am lokalen Listenobjekt vorgenommenen Änderungen, die noch nicht gespeichert wurden, werden nicht an die SharePoint-Liste gesendet. (Es wird keine Warnung angezeigt, dass diese nicht gespeicherten Änderungen verloren gehen.)

Beispiele

Im folgenden Codebeispiel wird ein ListObject im aktuellen Arbeitsblatt erstellt und ein Meldungsfeld angezeigt, in dem der Benutzer gefragt wird, ob das ListObject gelöscht werden soll. Wenn der Benutzer diese Frage bejaht, wird das ListObject mithilfe der Delete-Methode entfernt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ListObject Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über