Übersicht über das Benutzersteuerelement (Windows Forms .NET)

Ein Benutzersteuerelement ist eine Sammlung von Windows Forms-Steuerelementen, die in einem gemeinsamen Container gekapselt sind. Diese Art von Steuerelement wird als zusammengesetztes Steuerelement bezeichnet. Die enthaltenen Steuerelemente werden konstituierende Steuerelemente genannt. Benutzersteuerelemente leiten sich aus der UserControl-Klasse her.

Benutzersteuerelemente sind wie Formulare mit einem visuellen Designer konzipiert. Sie erstellen, ordnen und ändern die konstituierenden Steuerelemente über den visuellen Designer. Die Steuerelementereignisse und -logik werden genauso geschrieben wie beim Entwerfen eines Formulars. Das Benutzersteuerelement wird wie jedes andere Steuerelement auf einem Formular platziert.

Benutzersteuerelemente können vom Projekt verwendet werden, in dem sie erstellt werden, oder in anderen Projekten, die auf die Bibliothek des Benutzersteuerelements verweisen.

Wichtig

Der Desktopleitfaden zu .NET 7 und .NET 6 ist in Bearbeitung.

Konstituierende Steuerelemente

Die konstituierenden Steuerelemente sind für das Benutzersteuerelement verfügbar, und der App-Benutzer kann zur Laufzeit mit ihnen interagieren, aber die Eigenschaften und Methoden, die von den konstituierenden Steuerelementen deklariert werden, werden für den Consumer nicht verfügbar gemacht. Wenn Sie beispielsweise ein Steuerelement TextBox und Button auf dem Benutzersteuerelement platzieren, wird das Ereignis der Schaltfläche Click intern vom Benutzersteuerelement behandelt, aber nicht durch das Formular, in dem das Benutzersteuerelement platziert wird.

Hinzufügen eines Benutzersteuerelements zu einem Projekt

Verwenden Sie nach dem Erstellen eines neuen Projekts die Visual Studio-Vorlagen, um ein Benutzersteuerelement zu erstellen. Die folgenden Schritte veranschaulichen das Hinzufügen eines Benutzersteuerelements zu Ihrem Projekt:

  1. Suchen Sie in Visual Studio nach dem Bereich Projektmappen-Explorer. Klicken Sie mit der rechten Maustaste auf das Projekt und dann auf Hinzufügen>Benutzersteuerelement (Windows Forms).

    Klicken Sie mit der rechten Maustaste auf den Visual Studio-Projektmappen-Explorer, um einem Windows Forms-Projekt ein Benutzersteuerelement hinzuzufügen.

  2. Geben Sie im Textfeld Name einen Namen für Ihr Benutzersteuerelement ein. Visual Studio stellt einen eindeutigen Standardnamen bereit, den Sie verwenden können. Wählen Sie dann Hinzufügen aus.

    Dialogfeld „Hinzufügen“ in Visual Studio für Windows Forms

Nachdem das Benutzersteuerelement erstellt wurde, öffnet Visual Studio den Designer:

Der Benutzersteuerelement-Designer in Visual Studio für Windows Forms

Ein Beispiel für ein funktionierendes Benutzersteuerelement finden Sie unter Erstellen eines Benutzersteuerelements.