Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Method

Определение

Добавляет указанный элемент управления в коллекцию элементов управления.Adds the specified control to the control collection.

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

Параметры

value
Control Control Control Control

Объект Control, добавляемый в коллекцию элементов управления.The Control to add to the control collection.

Исключения

Указанный элемент управления — элемент управления верхнего уровня, или появляется циклическая ссылка на элемент управления, если этот элемент управления был добавлен в коллекцию элементов управления.The specified control is a top-level control, or a circular control reference would result if this control were added to the control collection.

Объект, присвоенный параметру value, не представляет собой элемент управления Control.The object assigned to the value parameter is not a Control.

Примеры

В следующем примере кода добавляется Control Control.ControlCollection в производный класс Panel.The following code example adds a Control to the Control.ControlCollection of the derived class Panel. Для этого примера требуется, чтобы был создан Panel элемент управления Button и элемент управления в Form.The example requires that you have created a Panel control and a Button control on a Form. При нажатии TextBox кнопки на Control.ControlCollectionпанели добавляется элемент управления.When the button is clicked, a TextBox control is added to the panel's Control.ControlCollection.

   // Create a TextBox to add to the Panel.
private:
   TextBox^ textBox1;

   // Add controls to the Panel using the Add method.
   void addButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      textBox1 = gcnew TextBox;
      panel1->Controls->Add( textBox1 );
   }
// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Add(textBox1);
}
  ' Create a TextBox to add to the Panel.
  Dim TextBox1 As TextBox = New TextBox()

  ' Add controls to the Panel using the Add method.
  Private Sub AddButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles AddButton.Click
      Panel1.Controls.Add(TextBox1)
  End Sub

Комментарии

Метод позволяет добавлять Control объекты в конец коллекции элементов управления. AddThe Add method allows you to add Control objects to the end of the control collection.

Можно также добавлять новые Control объекты в коллекцию AddRange с помощью метода.You can also add new Control objects to the collection by using the AddRange method.

Чтобы удалить Control добавленный ранее объект, Removeиспользуйте методы, RemoveAtили Clear .To remove a Control that you previously added, use the Remove, RemoveAt, or Clear methods.

Примечание

Может быть назначен только одному из них Control.ControlCollection за раз. ControlA Control can only be assigned to one Control.ControlCollection at a time. Если объект Control уже является дочерним элементом другого элемента управления, он удаляется из этого элемента управления перед добавлением в другой элемент управления.If the Control is already a child of another control it is removed from that control before it is added to another control.

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

При переопределении Add(Control) в производном классе обязательно вызовите Add(Control) метод базового класса, чтобы убедиться, что элемент управления добавлен в коллекцию.When overriding Add(Control) in a derived class, be sure to call the base class's Add(Control) method to ensure that the control is added to the collection.

Применяется к

Дополнительно