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.