ControlCollection.Remove(Control) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

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 .

Viz také

• RemoveAt(Int32)
• Controls