Control.ControlCollection.Remove(Control) メソッド


指定したコントロールをコントロール コレクションから削除します。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.ControlCollectionThe Control to remove from the Control.ControlCollection.

次のコード例では、コレクションのメンバーである場合 Panel 派生クラスの Control.ControlCollection から Control を削除します。The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. この例では、PanelButton、および1つ以上の RadioButton コントロールを Formに作成しておく必要があります。The example requires that you have created a Panel, a Button, and one or more RadioButton controls on a Form. RadioButton コントロールが Panel コントロールに追加され、Panel コントロールが Formに追加されます。The 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.

また、RemoveAt メソッドを使用して Control を削除したり、Clear メソッドを使用してすべてのコントロールを削除したりすることもできます。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.