Registrieren von Serviced Components
Eine Serviced Component wird von einer COM+-Anwendung gehostet, und diese Anwendung muss auf die Anwendung zugreifen können. Zur Sicherstellung der Zugriffsmöglichkeit bestehen für Serviced Components die folgenden Registrierungs- und Konfigurationsvoraussetzungen:
Die Assembly muss einen starken Namen haben. Weitere Informationen hierzu finden Sie unter Signieren einer Assembly mit einem starken Namen.
Die Assembly muss in der Windows-Registrierung registriert sein.
Typbibliotheksdefinitionen müssen registriert und in einer bestimmten COM+-Anwendung installiert sein.
Programmgesteuert hinzugefügte Dienste müssen im COM+-Katalog konfiguriert sein.
Für Serviced Components nützliche Registrierungsinformationen sind unter anderem:
COM+-Anwendungsidentität
Aktivierungstyp
Beschreibungsinformationen
COM+-Anwendungsidentität
Eine vorhandene COM+-Zielanwendung kann anhand des Namens oder der GUID identifiziert werden. Das .NET Services Installation-Tool (Regsvcs.exe) stellt für die Angabe eines Anwendungsnamens die Option /appname: bereit.
Informationen zum Angeben eines Anwendungsnamens finden Sie unter Verfahrensweise: Festlegen des Anwendungsnamens mithilfe des ApplicationName-Attributs.
Wenn Sie das ApplicationID-Attribut (oder das Guid-Attribut) auf eine Assembly anwenden, werden alle Suchvorgänge auf Grundlage dieser GUID durchgeführt, nicht anhand des Anwendungsnamens.
Informationen zum Angeben einer Anwendungs-ID finden Sie unter Verfahrensweise: Anwenden des ApplicationID-Attributs auf eine Assembly.
.gif) Hinweis: |
|---|
Bei der dynamischen Registrierung besteht die einzige Möglichkeit zum Angeben einer Zielanwendung darin, eins der Attribute ApplicationNameAttribute, ApplicationIDAttribute oder GuidAttribute zur Entwurfszeit anzuwenden. Das .NET Services Installation-Tool (Regsvcs.exe) stellt für die Angabe eines Anwendungsnamens oder einer GUID zur Kompilierzeit den Schalter /appname: bereit. Regsvcs.exe stellt außerdem den Schalter /parname: zur Angabe einer bestimmten COM+-Partition bereit. Der COM+-Partitionsdienst ist nur auf Windows Server 2003-Plattformen verfügbar. |
Wenn die Zielanwendung nicht angegeben oder gefunden wird, erstellt der Registrierungsmechanismus eine Anwendung unter Verwendung des vollständigen Namens der Assembly ohne die Versionsnummer.
.gif) Vorsicht: |
|---|
Verwenden Sie nicht das ApplicationIDAttribute-Attribut mit dem COM+-Partitionsdienst. Wenn Sie den COM+-Partitionsdienst verwenden, verhindert die Anwendung des ApplicationIDAttribute-Attributs die Partitionskonfiguration. Der COM+-Partitionsdienst ist nur auf Windows Server 2003-Plattformen verfügbar. |
Aktivierungstyp
Der Aktivierungstyp bestimmt, in welchem Prozess Ihre Serviced Components erstellt werden. Sie können das ApplicationActivationAttribute-Attribut auf eine Assembly anwenden, um den Aktivierungstyp anzugeben. Das ApplicationActivationAttribute-Attribut muss mit einem der beiden folgenden Enumerationswerte deklariert werden:
ActivationOption.Library: Gibt eine COM+-Bibliotheksanwendung an. Serviced Components in der Assembly werden im Prozess des Aufrufers aktiviert.
ActivationOption.Server: Gibt eine COM+-Bibliotheksanwendung an. Serviced Components in der Assembly werden in einem neuen, vom System bereitgestellten Prozess aktiviert.
| Hinweis: |
|---|
Informationen zum Festlegen des Aktivierungstyps einer Anwendung finden Sie unter Verfahrensweise: Festlegen des Aktivierungstyps einer Anwendung. |
| Hinweis: |
|---|
Wenn das ApplicationActivationAttribute-Attribut auf ActivationOption.Server festgelegt ist, müssen die Assembly sowie alle Assemblys, von denen diese abhängt, mithilfe von Windows Installer dem globalen Assemblycache (Global Assembly Cache, GAC) hinzugefügt werden, bevor die Serveranwendung verwendet werden kann. Andernfalls generiert die Anwendung eine Ausnahme. Darüber hinaus müssen, wenn das ApplicationActivationAttribute-Attribut auf ApplicationOption.Server festgelegt ist, alle Parameter für Serviced Components als System.Serializable gekennzeichnet sein oder von der System.MarshalByRefObject-Klasse abgeleitet werden. Ist dies nicht der Fall, generiert die Anwendung eine Ausnahme. |
Beschreibungsinformationen
Eine Beschreibung ist optional, aber manchmal nützlich, um ähnliche Assemblys unterscheiden zu können.
Informationen zum Angeben von Beschreibungsinformationen einer Anwendung finden Sie unter Verfahrensweise: Anwenden des Description-Attributs auf eine Assembly.
Die folgenden Themen in diesem Abschnitt beschreiben die Registrierungsmechanismen zum Bereitstellen von Anwendungen, die COM+-Dienste verwenden:
Beide Registrierungsmechanismen vereinfachen den Prozess der Registrierung, indem die zum Registrieren einer Serviced Component erforderlichen Schritte zusammengefasst werden. Beide erfordern, dass der Komponentenbenutzer ein Mitglied der Gruppe Administratoren ist. Bei der dynamischen Registrierung können Sie Registrierungsinformationen zur Entwurfszeit angeben sowie einige zur Kompilierzeit. Bei der manuellen Registrierung können Sie diese Informationen zur Entwurfszeit, zur Kompilierzeit und zur Registrierungszeit angeben. Wenn Sie Registrierungsinformationen auslassen, generiert der Registrierungsprozess diese aus Metadaten. Der Registrierungsprozess erkennt inkompatible Attributkombinationen und korrigiert diese auch manchmal.
Siehe auch
Aufgaben
Verfahrensweise: Erstellen einer Serviced Component
Referenz
ApplicationNameAttribute
ApplicationIDAttribute
GuidAttribute
ApplicationActivationAttribute
DescriptionAttribute
System.EnterpriseServices Namespace
Konzepte
Serviced Components – Übersicht
Anwenden von Attributen zum Konfigurieren von COM+-Diensten
Beispiel für Serviced Components
Zusammenfassung der verfügbaren COM+-Dienste
Weitere Ressourcen
Schreiben von Serviced Components
Extending Metadata Using Attributes
.gif)
Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.