ControlCollection.Remove-Methode (String)

Entfernt das Steuerelement mit dem angegebenen Namen aus der ControlCollection-Instanz.

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

Syntax

'Declaration
Function Remove ( _
    name As String _
) As Boolean

bool Remove(
    string name
)

Parameter

• name
  Typ: System.String
  Der Name des aus der ControlCollection-Instanz zu entfernenden Steuerelements.

Rückgabewert

Typ: System.Boolean

Hinweise

Steuerelemente, die zur Entwurfszeit hinzugefügt wurden, können nicht aus der ControlCollection-Instanz entfernt werden.Zur Laufzeit hinzugefügte Steuerelemente können Sie nur mit der Remove-Methode entfernen.

Beispiele

Im folgenden Codebeispiel werden dem Arbeitsblatt ein Button-Steuerelement und ein MonthCalendar-Steuerelement hinzugefügt.Wenn auf die Schaltfläche geklickt wird, wird das MonthCalendar-Steuerelement durch den Code entfernt.

Private Sub ExcelControlRemove()

    Dim Button1 As Microsoft.Office.Tools.Excel. _
        Controls.Button = Me.Controls.AddButton( _
        0, 0, 56.25, 17.25, "Button1")
    Dim MonthCalendar1 As Microsoft.Office.Tools. _
        Excel.Controls.MonthCalendar = Me.Controls. _
        AddMonthCalendar(0, 20, 75, 15, "MonthCalendar1")

    Button1.Text = "Remove"

    AddHandler Button1.Click, AddressOf Button1_Click

End Sub
Private Sub Button1_Click(ByVal sender As Object, ByVal e As _
    EventArgs)

    Me.Controls.Remove("MonthCalendar1")

End Sub

private void ExcelControlRemove()
{

    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25, 17.25,
        "button1");
    Microsoft.Office.Tools.Excel.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         0, 20, 75, 15, "monthCalendar1");
    button1.Text = "Remove";
    button1.Click += new EventHandler(button1_Click);

}

void button1_Click(object sender, EventArgs e)
{
    this.Controls.Remove("monthCalendar1");
}

.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

ControlCollection Schnittstelle

Remove-Überladung

Microsoft.Office.Tools.Excel-Namespace