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

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Control.ControlCollection.cs

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

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 в коллекцию элементов управления.

Исключения

Exception

Указанный элемент управления является элементом управления верхнего уровня или циклическая ссылка на элемент управления приведет к тому, что этот элемент управления был добавлен в коллекцию элементов управления.

ArgumentException

Объект, value назначенный параметру, не Controlявляется .

Примеры

В следующем примере кода добавляется Control в Control.ControlCollection производный класс Panel. В примере требуется, чтобы вы создали Panel элемент управления и Button элемент управления на объекте Form. При нажатии TextBox кнопки элемент управления добавляется в панель 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

Комментарии

Этот Add метод позволяет добавлять Control объекты в конец коллекции элементов управления.

Вы также можете добавить новые Control объекты в коллекцию AddRange с помощью метода.

Чтобы удалить добавленный Control ранее объект, используйте RemoveRemoveAtметоды или Clear методы.

Note

Можно Control назначить только один Control.ControlCollection раз. Если элемент Control управления уже является дочерним элементом другого элемента управления, он удаляется из этого элемента управления перед добавлением в другой элемент управления.

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

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

См. также

• Remove(Control)
• RemoveAt(Int32)
• AddRange(Control[])