Control.ControlCollection.Add(Control) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fügt der Steuerelementauflistung das angegebene Steuerelement hinzu.

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

value
Control

Das der Steuerelementauflistung hinzuzufügende Control.

Ausnahmen

Exception

Das angegebene Steuerelement ist ein Steuerelement der obersten Ebene. Andernfalls würde sich beim Hinzufügen dieses Steuerelements zur Steuerelementauflistung ein zirkulärer Verweis auf Steuerelemente ergeben.

ArgumentException

Das dem value-Parameter zugewiesene Objekt ist kein Control.

Beispiele

Im folgenden Codebeispiel wird der der Control.ControlCollection abgeleiteten Klasse Panelein Control hinzugefügt. Das Beispiel erfordert, dass Sie ein Panel -Steuerelement und ein Button -Steuerelement für eine Formerstellt haben. Wenn auf die Schaltfläche geklickt wird, wird dem Bereich Control.ControlCollectionein TextBox 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 Add der -Methode können Sie Objekte am Ende der Steuerelementauflistung hinzufügen Control .

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

Um eine Control zuvor hinzugefügte zu entfernen, verwenden Sie die RemoveMethoden , RemoveAtoder Clear .

Hinweis

Ein Control kann nur einzeln Control.ControlCollection zugewiesen werden. Wenn das Control bereits ein untergeordnetes Element eines anderen Steuerelements ist, wird es aus diesem Steuerelement entfernt, bevor es einem anderen Steuerelement hinzugefügt wird.

Hinweise für Vererber

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

Gilt für:

Weitere Informationen