ControlCollection.Remove(Control) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

public:
 virtual void Remove(System::Web::UI::Control ^ value);

public virtual void Remove (System.Web.UI.Control value);

abstract member Remove : System.Web.UI.Control -> unit
override this.Remove : System.Web.UI.Control -> unit

Public Overridable Sub Remove (value As Control)

Parameter

value

Control

Das zu entfernende Serversteuerelement

Beispiele

Im folgenden Codebeispiel wird die Remove -Methode verwendet, um ein untergeordnetes Steuerelement aus dem myButton Serversteuerelement zu löschen. Zunächst verwendet der Code die Contains -Methode, um zu bestimmen, ob das ControlCollectionmyChildControl im -Objekt enthalten ist, und entfernt es, wenn dies der Wert ist.

// 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." ;

' 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

Hinweise

Verwenden Sie die RemoveAt -Methode, um ein Steuerelement aus einem Indexspeicherort zu entfernen.

Weitere Informationen

• RemoveAt(Int32)
• Controls