Control.ControlCollection.Remove(Control) 方法

public:
 virtual void Remove(System::Windows::Forms::Control ^ value);

public 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)

參數

範例

以下程式碼範例若 a 是該集合的成員，則會從衍生類別Control中移除 a。Control.ControlCollectionPanel 範例要求你建立了一個Panel、一個Button、以及一個或多個RadioButton控制項。Form RadioButton控制項會加入到控制項Panel上，Panel控制項又加入到。Form 當按鈕被點擊時，該名稱 radioButton2 的單選按鈕會從 Control.ControlCollection.

   // Remove the RadioButton control if it exists.
private:
   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)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

' 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
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

備註

當 a Control 從控制集合中移除時，所有後續控制項會在集合中往上移動一個位置。

你也可以用這個Control方法移除 aRemoveAt，或是用這個Clear方法移除所有控制項。

要新增 Control 物件到集合中，請使用 Add or AddRange 方法。

給繼承者的注意事項

在導出類別中覆 Remove(Control) 寫時，務必呼叫基底類別的方法 Remove(Control) ，確保該控制項從集合中移除。

另請參閱

• RemoveAt(Int32)
• Clear()
• Add(Control)