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


指定したコントロールをコントロール コレクションから削除します。Removes the specified control from the control collection.

 virtual void Remove(System::Windows::Forms::Control ^ value);
public virtual void Remove (System.Windows.Forms.Control value);
abstract member Remove : System.Windows.Forms.Control -> unit
override this.Remove : System.Windows.Forms.Control -> unit
Public Overridable Sub Remove (value As Control)


次のコード例ではControl 、がControl.ControlCollectionコレクションのメンバーでPanelある場合、派生クラスのからを削除します。The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. この例では、、、およびPanel1 つButton RadioButton以上のコントロールをにForm作成しておく必要があります。The example requires that you have created a Panel, a Button, and one or more RadioButton controls on a Form. コントロールがPanel FormコントロールPanelに追加され、コントロールがに追加されます。 RadioButtonThe RadioButton controls are added to the Panel control, and the Panel control is added to the Form. ボタンがクリックされると、という名前radioButton2のラジオボタンがControl.ControlCollectionから削除されます。When the button is clicked, the radio button named radioButton2 is removed from the Control.ControlCollection.

   // Remove the RadioButton control if it exists.
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      if ( panel1->Controls->Contains( removeButton ) )
         panel1->Controls->Remove( removeButton );
// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
  ' Remove the RadioButton control if it exists.
  Private Sub RemoveButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles RemoveButton.Click
      If Panel1.Controls.Contains(RemoveButton) Then
      End If
  End Sub


Controlがコントロールコレクションから削除されると、後続のすべてのコントロールがコレクション内の1つ上の位置に移動します。When a Control is removed from the control collection, all subsequent controls are moved up one position in the collection.

メソッドをClear Control RemoveAt使用してを削除したり、メソッドを使用してすべてのコントロールを削除したりすることもできます。You can also remove a Control by using the RemoveAt method, or remove all controls by using the Clear method.

コレクションに新しいControlオブジェクトを追加するにAddは、メソッドAddRangeまたはメソッドを使用します。To add new Control objects to the collection, use the Add or AddRange methods.

注意 (継承者)

派生クラスRemove(Control)でをオーバーライドする場合は、必ず基底クラスのRemove(Control)メソッドを呼び出して、コントロールがコレクションから確実に削除されるようにしてください。When overriding Remove(Control) in a derived class, be sure to call the base class's Remove(Control) method to ensure that the control is removed from the collection.