Manuelles Registrieren einer Assembly

Für die manuelle Registrierung einer Assembly, die Serviced Components enthält, kann das .NET Framework Services Installation-Tool (Regsvcs.exe) im .NET Framework SDK verwendet werden. Bei Regsvcs.exe handelt es sich um ein Befehlszeilentool. Mit Hilfe der System.EnterpriseServices.RegistrationHelper-Klasse kann auch programmgesteuert auf die Registrierungsfunktionen zugegriffen werden. Dazu wird eine Instanz der RegistrationHelper-Klasse erstellt und die InstallAssembly-Methode verwendet.

Obwohl nicht immer erforderlich, ist es dennoch hilfreich, Assemblies für das Testen während der Entwurfsphase manuell zu registrieren. Anders als bei der dynamischen wird bei der manuellen Registrierung ein Feedback über die Fehler gegeben, die während der Ausführung aufgetreten sind.

**Hinweis   **Wenn Sie eine Serveranwendung erstellen, müssen die Assembly und alle Assemblies, von denen sie abhängig ist, mit Windows Installer dem globalen Assemblycache (GAC) hinzugefügt werden, bevor die Serveranwendung verwendet werden kann. Andernfalls wird durch die Anwendung eine Ausnahme ausgelöst.

In der folgenden Tabelle sind die von Regsvcs.exe (oder der API) ausgeführten Schritte und die Fehler dargestellt, die dabei auftreten können.

Schritt	Möglicher Fehler	Ergebnis
Laden der Assembly.	Die Assembly kann nicht geladen werden.	Anzeige einer Fehlermeldung und einer Fehlerbeschreibung.
Registrieren der Assembly.	Die Typregistrierung schlägt fehl.	Ungenügend spezifizierte Assemblies führen zu einer TypeLoadException-Ausnahme.
Erzeugen einer Typbibliothek	Das Generieren der Bibliothek schlägt fehl.	Ungenügend spezifizierte Assemblies führen zu einer TypeLoadException-Ausnahme.
Registrierung der Typbibliothek durch Aufruf der LoadTypeLibrary-Methode.	Der Automatisierungsaufruf schlägt fehl.	Eine TypeLoadException-Ausnahme wird ausgelöst.
Installation der Typbibliothek in die angeforderte Anwendung.	Die angegebene Anwendung wird vom Assembly Registration-Tool (Regasm.exe) nicht gefunden.	Anzeige der Fehlermeldung "Eines der Objekte wurde nicht gefunden." Beheben Sie den Fehler, indem Sie den Standort der angegebenen Typbibliothek und der Anwendung bestätigen.
Konfigurieren der Klasse.	Während der Registrierung wird durch das Tool die Unverträglichkeit von Attributen des Dienstes entdeckt. Dies kann beispielsweise der Fall sein, wenn in einer Klasse Eigenschaften verwendet wurden, die miteinander in Konflikt stehen, wie z. B.: TransactionOption.Required SynchonizationOption.Disabled	Anzeige eines Fehlers mit der Beschreibung des Konflikts oder Modifizierung eines der betroffenen Dienste.

Siehe auch

Registrieren von Serviced Components | Dynamisches Registrieren einer Assembly | .NET Framework Services Installation-Tool (Regsvcs.exe) | System.EnterpriseServicesRegistrationHelper | System.EnterpriseServices-Namespace