ControlCollection.Remove-Methode

Artikel
08/20/2007

Entfernt das angegebene Serversteuerelement aus dem ControlCollection-Objekt des übergeordneten Serversteuerelements.

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

Syntax

'Declaration
Public Overridable Sub Remove ( _
    value As Control _
)
'Usage
Dim instance As ControlCollection
Dim value As Control

instance.Remove(value)

public virtual void Remove (
    Control value
)

public:
virtual void Remove (
    Control^ value
)

public void Remove (
    Control value
)

public function Remove (
    value : Control
)

Parameter

value
Das zu entfernende Serversteuerelement.

Hinweise

Ein Steuerelement wird mithilfe der RemoveAt-Methode aus einer Indexposition entfernt.

Beispiel

Im folgenden Codebeispiel wird mithilfe der Remove-Methode ein untergeordnetes Steuerelement aus dem myButton-Serversteuerelement gelöscht. Zunächst wird mit der Contains-Methode bestimmt, ob myChildControl im ControlCollection-Objekt enthalten ist, und dieses dann ggf. entfernt.

' Use the Contains method to check whether
' a child control exists, and if it does,
' use the Remove method to delete it.        
If myButton.Controls.Contains(myChildControl)
   myButton.Controls.Remove(myChildControl)
   msgRemove.Text = "You removed myLiteralControl."
Else
   msgRemove.Text="The control to remove does not exist." 
End If

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
RemoveAt
Control.Controls-Eigenschaft

Freigeben über