Problembehandlung beim Erstellen von Komponenten und Steuerelementen

Artikel
08/10/2011

Unter diesem Thema sind die folgenden Probleme aufgeführt, die bei der Entwicklung von Komponenten und Steuerelementen häufig auftreten. Weitere Informationen finden Sie unter Programmieren mit Komponenten.

Hinzufügen eines Steuerelements zu einer Toolbox nicht möglich
Debuggen des Windows Forms-Benutzersteuerelements bzw. einer Komponente nicht möglich
Ereignis wird im geerbten Steuerelement bzw. in der geerbten Komponente zweimal ausgelöst
Entwurfszeitfehler: "Fehler beim Erstellen der Komponente 'Komponentenname'"
STAThreadAttribute
Komponentensymbol wird nicht in der Toolbox angezeigt.

Hinzufügen eines Steuerelements zu einer Toolbox nicht möglich

Wenn Sie in die Toolbox ein benutzerdefiniertes Steuerelement, das Sie in einem anderen Projekt erstellt haben, bzw. ein Steuerelement von Drittanbieter aufnehmen möchten, müssen Sie diesen Vorgang manuell durchführen. Wenn das Steuerelement oder die Komponente im aktuellen Projekt enthalten ist, sollte es bzw. sie automatisch in der Toolbox angezeigt werden. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Automatisches Füllen der Toolbox mit benutzerdefinierten Komponenten.

So fügen Sie der Toolbox ein Steuerelement hinzu

Klicken Sie mit der rechten Maustaste auf die Toolbox, und wählen Sie im Kontextmenü die Option Elemente auswählen aus.
Fügen Sie im Dialogfeld Toolboxelemente auswählen die Komponente hinzu:
- Wenn Sie eine .NET Framework-Komponente bzw. ein entsprechendes Steuerelement hinzufügen möchten, klicken Sie auf die Registerkarte .NET Framework-Komponenten.
  
  – oder –
- Wenn Sie eine COM-Komponente bzw. ein ActiveX-Steuerelement hinzufügen möchten, klicken Sie auf die Registerkarte COM-Komponenten.
Wenn das Steuerelement im Dialogfeld aufgeführt ist, stellen Sie sicher, dass es ausgewählt ist. Klicken Sie anschließend auf OK.

Das Steuerelement wird der Toolbox hinzugefügt.
Wenn das gewünschte Steuerelement nicht im Dialogfeld aufgeführt ist, gehen Sie wie folgt vor:
1. Klicken Sie auf die Schaltfläche Durchsuchen.
2. Wechseln Sie in den Ordner mit der DLL-Datei, die das Steuerelement enthält.
3. Wählen Sie die DLL-Datei aus, und klicken Sie auf Öffnen.
  
  Das Steuerelement wird im Dialogfeld angezeigt.
4. Stellen Sie sicher, dass das Steuerelement ausgewählt ist, und klicken Sie dann auf OK.
  
  Das Steuerelement wird der Toolbox hinzugefügt.

Debuggen des Windows Forms-Benutzersteuerelements bzw. einer Komponente nicht möglich

Wenn sich das Steuerelement von der UserControl-Klasse ableitet, können Sie sein Laufzeitverhalten mit dem Testcontainer debuggen. Weitere Informationen finden Sie unter Gewusst wie: Testen des Laufzeitverhaltens eines UserControl.

Andere benutzerdefinierte Steuerelemente und Komponenten sind keine eigenständigen Projekte. Sie müssen von einer Anwendung, z. B. einem Windows Forms-Projekt, gehostet werden. Für das Debuggen eines Steuerelements oder einer Komponente müssen Sie es/sie einem Windows Forms-Projekt hinzufügen.

So debuggen Sie ein Steuerelement bzw. eine Komponente

Klicken Sie im Menü Erstellen auf Projektmappe erstellen.
Wählen Sie im Menü Datei die Option Hinzufügen und anschließend Neues Projekt, um der Anwendung ein Testprojekt hinzuzufügen.
Wählen Sie im Dialogfeld Neues Projekt hinzufügen die Option Windows-Anwendung für den Projekttyp.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise für das neue Projekt. Klicken Sie im Kontextmenü auf Verweis hinzufügen, um dem Projekt mit dem Steuerelement oder der Komponente einen Verweis hinzuzufügen.
Erstellen Sie eine Instanz des Steuerelements bzw. der Komponente im Testprojekt. Wenn sich die Komponente in der Toolbox befindet, können Sie sie auf die Designeroberfläche ziehen. Wahlweise können Sie die Instanz auch wie im nächsten Codebeispiel gezeigt programmgesteuert erstellen:
```
Dim Component1 As New MyNeatComponent()
```
```
MyNeatComponent Component1 = new MyNeatComponent();
```
Jetzt können Sie das Steuerelement bzw. die Komponente wie gewohnt debuggen.

Weitere Informationen zum Debuggen finden Sie unter Debuggen in Visual Studio und Exemplarische Vorgehensweise: Debuggen von benutzerdefinierten Windows Forms-Steuerelementen zur Entwurfszeit.

Ereignis wird im geerbten Steuerelement bzw. in der geerbten Komponente zweimal ausgelöst

Ursache dafür ist mit großer Wahrscheinlichkeit eine doppelt vorliegende Handles-Klausel. Weitere Informationen finden Sie unter Problembehandlung für geerbte Ereignishandler in Visual Basic.

Entwurfszeitfehler: "Fehler beim Erstellen der Komponente 'Komponentenname'"

Die Komponente oder das Steuerelement muss einen Standardkonstruktor ohne Parameter bereitstellen. Wenn die Entwurfsumgebung eine Instanz des Steuerelements oder der Komponente erstellt, versucht sie nicht, Parameter für Konstruktorüberladungen bereitzustellen, die Parameter enthalten.

STAThreadAttribute

Das STAThreadAttribute informiert die Common Language Runtime (CLR), dass Windows Forms das Singlethread-Apartmentmodell verwendet. Wenn Sie dieses Attribut nicht auf die Main-Methode der Windows Forms-Anwendung anwenden, kann es zu unerwartetem Verhalten kommen. Zum Beispiel werden Hintergrundbilder möglicherweise für Steuerelemente wie ListView nicht angezeigt. Einige Steuerelemente benötigen dieses Attribut möglicherweise auch zur ordnungsgemäßen automatischen Vervollständigung und für das Drag & Drop-Verhalten.

Komponentensymbol wird nicht in der Toolbox angezeigt.

Wenn Sie ToolboxBitmapAttribute zum Verknüpfen eines Symbols mit der benutzerdefinierten Komponente verwenden, wird in der Toolbox für automatisch erstellte Komponenten keine Bitmap angezeigt. Damit die Bitmap angezeigt wird, müssen Sie das Steuerelement über das Dialogfeld Toolboxelemente auswählen neu laden. Weitere Informationen finden Sie unter Gewusst wie: Bereitstellen einer Toolboxbitmap für ein Steuerelement.