ControlCollection.Remove(Control) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Odebere zadaný ovládací prvek serveru z objektu ControlCollection nadřazeného ovládacího prvku serveru.

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)

Parametry

value: Control

Ovládací prvek serveru, který se má odebrat.

Příklady

Následující příklad kódu používá metodu Remove k odstranění podřízeného ovládacího prvku z myButton ovládacího prvku serveru. Nejprve kód použije metodu Contains k určení, zda myChildControl je obsažen v objektu ControlCollection , a pokud ano, odebere ji.

// 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

Poznámky

Chcete-li odebrat ovládací prvek z umístění indexu, použijte metodu RemoveAt .

Platí pro