Freigeben über

Exemplarische Vorgehensweise: Automatisches Auffüllen der Toolbox mit benutzerdefinierten Komponenten

Wenn Ihre Komponenten von einem Projekt in der aktuell geöffneten Projektmappe definiert werden, werden sie automatisch in der Toolbox angezeigt, ohne dass eine Aktion von Ihnen erforderlich ist. Sie können die Toolbox auch manuell mit Ihren benutzerdefinierten Komponenten auffüllen, indem Sie das Dialogfeld "Toolboxelemente auswählen" (Visual Studio) verwenden, die Toolbox berücksichtigt jedoch Elemente in den Buildausgaben Ihrer Lösung mit allen folgenden Merkmalen:

Vorsicht

Dieser Inhalt wurde für .NET Framework geschrieben. Wenn Sie .NET 6 oder eine höhere Version verwenden, verwenden Sie diesen Inhalt mit Vorsicht. Das Designersystem hat sich für Windows Forms geändert, und es ist wichtig, dass Sie die Änderungen im Designer seit dem .NET Framework Artikel überprüfen.

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie eine benutzerdefinierte Komponente automatisch in der Toolbox angezeigt wird, sobald die Komponente erstellt wurde. In dieser exemplarischen Vorgehensweise werden u. a. folgende Aufgaben veranschaulicht:

  • Erstellen eines Windows Forms-Projekts.

  • Erstellen einer benutzerdefinierten Komponente.

  • Erstellen einer Instanz einer benutzerdefinierten Komponente.

  • Entladen und Neuladen einer benutzerdefinierten Komponente.

Wenn Sie fertig sind, sehen Sie, dass die Toolbox mit einer Komponente aufgefüllt wird, die Sie erstellt haben.

Hinweis

Die Toolbox zeigt nur Komponenten aus Bibliotheken an, die direkt von Ihrem Projekt referenziert werden oder die von einem Projekt in der Projektmappe definiert sind.

Erstelle das Projekt

  1. Erstellen Sie in Visual Studio ein Windows-basiertes Anwendungsprojekt namens ToolboxExample "File>New>Project>Visual C# " oder "Visual Basic>Classic Desktop>Windows Forms Application".

  2. Fügen Sie dem Projekt eine neue Komponente hinzu. Nennen Sie es DemoComponent.

    Weitere Informationen finden Sie in How to: Add New Project Items.

  3. Projekt erstellen.

  4. Klicken Sie im Menü "Extras " auf das Element "Optionen" . Klicken Sie unter dem Windows Forms Designer-Element auf "Allgemein", und stellen Sie sicher, dass die Option "AutoToolboxPopulate" auf "True" festgelegt ist.

Erstellen einer Instanz einer benutzerdefinierten Komponente

Der nächste Schritt besteht darin, eine Instanz der benutzerdefinierten Komponente im Formular zu erstellen. Da die Toolbox automatisch die neue Komponente beschafft, ist dies so einfach wie das Erstellen einer anderen Komponente oder eines anderen Steuerelements.

  1. Öffnen Sie das Formular des Projekts im Formular-Designer.

  2. Klicken Sie in der Toolbox auf die neue Registerkarte "ToolboxExample-Komponenten".

    Nachdem Sie auf die Registerkarte geklickt haben, wird "DemoComponent" angezeigt.

    Hinweis

    Aus Leistungsgründen zeigen Komponenten im automatisch aufgefüllten Bereich der Toolbox keine benutzerdefinierten Bitmaps an, und ToolboxBitmapAttribute wird nicht unterstützt. Um ein Symbol für eine benutzerdefinierte Komponente in der Toolbox anzuzeigen, verwenden Sie das Dialogfeld "Toolboxelemente auswählen ", um die Komponente zu laden.

  3. Ziehen Sie Ihre Komponente auf Ihr Formular.

    Eine Instanz der Komponente wird erstellt und der Komponentenleiste hinzugefügt.

Entladen und erneutes Laden einer benutzerdefinierten Komponente

Die Toolbox berücksichtigt die Komponenten in jedem geladenen Projekt und entfernt beim Entladen eines Projekts Verweise auf die Komponenten des Projekts.

  1. Entladen Sie das Projekt aus der Lösung.

    Weitere Informationen zum Entladen von Projekten finden Sie unter How to: Unload and Reload Projects. Wenn Sie zum Speichern aufgefordert werden, wählen Sie "Ja" aus.

  2. Fügen Sie der Projektmappe ein neues Windows-Anwendungsprojekt hinzu. Öffnen Sie das Formular im Designer.

    Die Registerkarte "ToolboxExample-Komponenten " aus dem vorherigen Projekt ist jetzt nicht mehr vorhanden.

  3. Laden Sie das ToolboxExample Projekt neu.

    Die Registerkarte "ToolboxExample-Komponenten " wird jetzt wieder angezeigt.

Nächste Schritte

In dieser exemplarischen Vorgehensweise wird veranschaulicht, dass die Toolbox die Komponenten eines Projekts berücksichtigt, aber die Toolbox berücksichtigt auch Steuerelemente. Experimentieren Sie mit Ihren eigenen benutzerdefinierten Steuerelementen, indem Sie Steuerelementprojekte aus Ihrer Lösung hinzufügen und entfernen.

Siehe auch