Control.ControlCollection.Remove(Control) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Удаляет указанный элемент управления из коллекции.

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)

Параметры

value

Control

Элемент Control, который требуется удалить из Control.ControlCollection.

Примеры

В следующем примере кода удаляется Control из Control.ControlCollection производного класса Panel , если он является членом коллекции. В этом примере требуется создать 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

Комментарии

При удалении Control из коллекции элементов управления все последующие элементы управления перемещаются вверх на одну позицию в коллекции.

Можно также удалить Control с помощью RemoveAt метода или удалить все элементы управления с помощью Clear метода .

Чтобы добавить новые Control объекты в коллекцию, используйте методы Add или AddRange .

Примечания для тех, кто наследует этот метод

При переопределении Remove(Control) в производном классе обязательно вызовите метод базового класса Remove(Control) , чтобы убедиться, что элемент управления удален из коллекции.

См. также раздел

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