Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

Form.ControlCollection-Klasse

Aktualisiert: November 2007

Stellt eine Auflistung von Steuerelementen im Formular dar.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[ComVisibleAttribute(false)]
public class ControlCollection : Control..::.ControlCollection
/** @attribute ComVisibleAttribute(false) */
public class ControlCollection extends Control..::.ControlCollection
public class ControlCollection extends Control..::.ControlCollection

Diese Klasse stellt die Auflistung von Steuerelementen dar, die in einem Formular enthalten sind. Mit der Add-Methode können Sie dem Formular ein Steuerelement hinzufügen, und mit der Remove-Methode können Sie das Steuerelement aus dem Formular entfernen. Die Steuerelementauflistung, die durch diese Klasse dargestellt wird, kann nicht ohne Bindung an ein bestimmtes Formular erstellt werden. Daher können Sie nicht mehrere Instanzen dieser Steuerelementauflistung erstellen und diese für ein aktives Formular austauschen, um unterschiedliche Steuerelementlayouts bereitzustellen.

Im folgenden Codebeispiel wird der Steuerelementauflistung eines Formulars ein TextBox-Steuerelement und ein Label-Steuerelement hinzugefügt. Im Beispiel ist es erforderlich, dass ein Formular mit dem Namen Form1 erstellt wurde.

public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();

    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);

    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }



Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: