Control.ControlCollection.Add(Control) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Ausnahmen
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.
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.