ControlCollection.Remove(Control) ControlCollection.Remove(Control) ControlCollection.Remove(Control) ControlCollection.Remove(Control) Method

定義

親サーバー コントロールの ControlCollection オブジェクトから、指定したサーバー コントロールを削除します。Removes the specified server control from the parent server control's ControlCollection object.

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)

パラメーター

value
Control Control Control Control

削除されるサーバー コントロール。The server control to be removed.

次のコード例ではRemove 、メソッドを使用して、 myButtonサーバーコントロールから子コントロールを削除します。The following code example uses the Remove method to delete a child control from the myButton server control. まず、コードはContainsメソッドを使用して、 myChildControlControlCollectionオブジェクトに含まれているかどうかを確認し、存在する場合はそれを削除します。First the code uses the Contains method to determine whether the myChildControl is contained in the ControlCollection object, and, if it is, removes it.

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

注釈

インデックス位置からコントロールを削除するには、 RemoveAtメソッドを使用します。To remove a control from an index location, use the RemoveAt method.

適用対象

こちらもご覧ください