ControlCollection.RemoveAt-Methode
Entfernt das Steuerelement am angegebenen Index in der ControlCollection-Instanz.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
Sub RemoveAt ( _
index As Integer _
)
void RemoveAt(
int index
)
Parameter
- index
Typ: System.Int32
Der nullbasierte Index des aus der ControlCollection-Instanz zu entfernenden Steuerelements.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentOutOfRangeException | Der Index ist kleiner als 0 (null), oder der Index ist größer als oder gleich der Anzahl. |
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 RemoveAt-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 durch den Index angegebene MonthCalendar-Steuerelement durch den Code entfernt.
Private Sub ExcelControlRemoveAt()
Dim Button2 As Microsoft.Office.Tools.Excel. _
Controls.Button = Me.Controls.AddButton( _
0, 0, 56.25, 17.25, "Button2")
Dim MonthCalendar1 As Microsoft.Office.Tools. _
Excel.Controls.MonthCalendar = Me.Controls. _
AddMonthCalendar(0, 20, 75, 15, "MonthCalendar1")
Button2.Text = "Remove"
AddHandler Button2.Click, AddressOf Button2_Click
End Sub
Private Sub Button2_Click(ByVal sender As Object, ByVal e _
As EventArgs)
Me.Controls.RemoveAt(1)
End Sub
private void ExcelControlRemoveAt()
{
Microsoft.Office.Tools.Excel.Controls.Button button2 =
this.Controls.AddButton(0, 0, 56.25, 17.25,
"button2");
Microsoft.Office.Tools.Excel.Controls.MonthCalendar
monthCalendar1 = this.Controls.AddMonthCalendar(
0, 20, 75, 15, "monthCalendar1");
button2.Text = "Remove";
button2.Click += new EventHandler(button2_Click);
}
void button2_Click(object sender, EventArgs e)
{
this.Controls.RemoveAt(1);
}
.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.