Control.ControlCollection.Add-Methode

Fügt der Steuerelementauflistung das angegebene Steuerelement hinzu.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overridable Sub Add ( _
    value As Control _
)
'Usage
Dim instance As ControlCollection
Dim value As Control

instance.Add(value)

public virtual void Add (
    Control value
)

public:
virtual void Add (
    Control^ value
)

public void Add (
    Control value
)

public function Add (
    value : Control
)

Parameter

• value
  Das der Steuerelementauflistung hinzuzufügende Control.

Ausnahmen

Hinweise

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

Sie können der Auflistung auch unter Verwendung der AddRange-Methode neue Control-Objekte hinzufügen.

Verwenden Sie die Remove-Methode, die RemoveAt-Methode oder die Clear-Methode, um ein zuvor hinzugefügtes Control zu entfernen.

Hinweise für Erben Wenn Sie Add in einer abgeleiteten Klasse überschreiben, müssen Sie die Add-Methode der Basisklasse aufrufen, um sicherzustellen, dass das Steuerelement der Auflistung hinzugefügt wird.

Beispiel

Im folgenden Codebeispiel wird der Control.ControlCollection des Panel der abgeleiteten Klasse ein Control hinzugefügt. Im Beispiel wird davon ausgegangen, dass ein Panel-Steuerelement und ein Button-Steuerelement in einem Form erstellt wurden. Beim Klicken auf die Schaltfläche wird der Control.ControlCollection des Bereichs ein TextBox-Steuerelement hinzugefügt.

' 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

// 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.
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.get_Controls().Add(textBox1);
} //addButton_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control.ControlCollection-Klasse
Control.ControlCollection-Member
System.Windows.Forms-Namespace
Remove
RemoveAt
AddRange