ControlCollection.RemoveAt-Methode

Artikel
08/20/2007

Entfernt ein untergeordnetes Steuerelement an der angegebenen Indexposition aus dem ControlCollection-Objekt.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Sub RemoveAt ( _
    index As Integer _
)
'Usage
Dim instance As ControlCollection
Dim index As Integer

instance.RemoveAt(index)

public virtual void RemoveAt (
    int index
)

public:
virtual void RemoveAt (
    int index
)

public void RemoveAt (
    int index
)

public function RemoveAt (
    index : int
)

Parameter

index
Der Ordinalindex des Serversteuerelements, das aus der Auflistung entfernt werden soll.

Ausnahmen

Ausnahmetyp	Bedingung
HttpException	Wird ausgelöst, wenn ControlCollection schreibgeschützt ist.

Hinweise

Mithilfe der Remove-Methode wird ein Steuerelement entsprechend seinem Wert aus der Auflistung entfernt.

Beispiel

Im folgenden Codebeispiel wird mithilfe der RemoveAt-Methode ein untergeordnetes Steuerelement aus dem myButton-Serversteuerelement gelöscht. Beim Aufruf der Methode wird zunächst die Indexposition 1 angegeben, von der das Steuerelement gelöscht wird. Dann wird eine Textmeldung auf die enthaltende Seite geschrieben, die besagt, dass das Steuerelement an dieser Position aus der ControlCollection-Auflistung gelöscht wurde.

' Use the RemoveAt method to delete the child control
' at index location 1.           
myButton.Controls.RemoveAt(1)
msgRemoveAt.Text = "The control at index location 1 has been removed."

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ControlCollection-Klasse
ControlCollection-Member
System.Web.UI-Namespace
Control.Controls-Eigenschaft
Remove

Freigeben über