Control.ControlCollection.Add(Control) Methode

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

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird der Control abgeleiteten Klasse Control.ControlCollectionein Add-In Panel hinzugefügt. Das Beispiel erfordert, dass Sie ein Panel Steuerelement und ein Button Steuerelement für ein Steuerelement Formerstellt haben. Wenn auf die Schaltfläche geklickt wird, wird dem Panel TextBoxein Control.ControlCollection Steuerelement hinzugefügt.

   // 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

Hinweise

Mit der Add Methode können Sie am Ende der Steuerelementauflistung Objekte hinzufügen Control .

Sie können der Auflistung auch neue Control Objekte hinzufügen, indem Sie die AddRange Methode verwenden.

Um ein zuvor hinzugefügtes Element Control zu entfernen, verwenden Sie die RemoveMethoden oder RemoveAtClear Methoden.

Hinweise für Vererber

Achten Sie beim Überschreiben Add(Control) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse Add(Control) aufzurufen, um sicherzustellen, dass das Steuerelement der Auflistung hinzugefügt wird.

Weitere Informationen

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