COM+-Verwaltungssammlungen
Die COM+-Verwaltungssammlungen dienen zum Speichern und Organisieren von Konfigurationsdaten, die im COM+-Katalog gespeichert sind. Die Sammlungen entsprechen Ordnern in der Konsolenstruktur des Verwaltungstool Komponentendienste. Sie können mithilfe der COM+-Verwaltungsobjekte und -Schnittstellen auf diese Sammlungen zugreifen.
Sie initiieren die programmgesteuerte Verwaltung mithilfe von Objekten, die aus der COMAdminCatalog-Klasse erstellt wurden. Sie stellen alle Sammlungen im Katalog mithilfe von Objekten dar, die aus der COMAdminCatalogCollection-Klasse erstellt wurden, und Sie stellen Elemente in Auflistungen mithilfe von Objekten dar, die aus der COMAdminCatalogObject-Klasse erstellt wurden.
Die Elemente in einer bestimmten Auflistung machen einen konsistenten Satz von Eigenschaften verfügbar. Beispielsweise stellt jedes Element in der Components-Auflistung eine Komponente dar, und die Elemente in der Components-Auflistung machen die gleichen Eigenschaften verfügbar, die zum Konfigurieren einer Komponente verwendet wurden. Auf diese Eigenschaften kann mithilfe der COMAdminCatalogObject-Klasse zugegriffen werden.
Hinweis
Eigenschaften mit WriteOnce-Zugriff sind ReadWrite, während die Add-Methode vor der Verwendung von SaveChanges verwendet wird, und sind anschließend ReadOnly.
Eine Einführung in die programmgesteuerte Verwaltung von COM+ finden Sie unter Automatisieren der COM+-Verwaltung.
Sammlungshierarchie
Die folgende Abbildung veranschaulicht die Beziehungen zwischen den Auflistungen. Die Auflistungen ganz links (in weißen und grauen Feldern) sind Sammlungen der obersten Ebene, auf die durch Aufrufen der GetCollection-Methode eines Objekts zugegriffen wird, das aus der COMAdminCatalog-Klasse erstellt wurde. Auf die verbleibenden Auflistungen (in gelben Feldern) kann nur über die übergeordnete Auflistung zugegriffen werden, indem die GetCollection-Methode des COMAdminCatalogCollection-Objekts aufgerufen wird, das das übergeordnete Element darstellt. Die Pfeile zeigen von einer übergeordneten Auflistung auf die untergeordneten Auflistungen.

Die folgenden vier Auflistungen sind in der Abbildung nicht dargestellt: ErrorInfo, PropertyInfo, RelatedCollectionInfound Root. Die ErrorInfo-Sammlung ist ein untergeordnetes Element jeder Sammlung in der Abbildung, mit Ausnahme von InprocServers und WOWInprocServers (in grauen Feldern). Die PropertyInfo- und RelatedCollectionInfo-Auflistungen sind children jeder Auflistung. Die Root-Auflistung ist eine Auflistung der obersten Ebene, die allen anderen Auflistungen der obersten Ebene über-übergeordnete Auflistungen ist. Es ist jedoch nicht erforderlich, vor dem Zugriff auf andere Sammlungen der obersten Ebene auf die Stammsammlung zu zugreifen.
COMAdmin-Bibliothek
Die folgenden Sammlungen werden von der COMAdmin-Bibliothek unterstützt.
| Sammlung | BESCHREIBUNG |
|---|---|
| ApplicationCluster | Enthält eine Liste der Server im Anwendungscluster. |
| ApplicationInstances | Enthält ein -Objekt für jede Instanz einer ausgeführten COM+-Anwendung. |
| Anwendungen | Enthält ein -Objekt für jede COM+-Anwendung, die auf dem lokalen Computer installiert ist. |
| Komponenten | Enthält ein -Objekt für jede Komponente in der Anwendung, mit der sie verknüpft ist. |
| ComputerList | Enthält eine Liste der Computer, die sich im Ordner Computer des Verwaltungstool Komponentendienste befinden. |
| DCOMProtocols | Enthält eine Liste der Protokolle, die von DCOM verwendet werden sollen. Sie enthält ein -Objekt für jedes Protokoll. |
| ErrorInfo | Ruft erweiterte Fehlerinformationen zu Methoden ab, die mehrere Objekte behandeln. |
| EventClassesForIID | Ruft Informationen zu Ereignisklassen ab. |
| FilesForImport | Ruft Informationen zu einer Anwendung, die importiert werden kann, aus der MSI-Datei ab. |
| InprocServers | Enthält eine Liste der Prozessserver, die beim System registriert sind. Sie enthält ein -Objekt für jede Komponente. |
| InterfacesForComponent | Enthält ein -Objekt für jede Schnittstelle, die von der Komponente verfügbar gemacht wird, mit der die Auflistung verknüpft ist. |
| LegacyComponents | Enthält ein -Objekt für jede nicht konfigurierte Komponente in der Anwendung, mit der sie verknüpft ist. |
| LegacyServers | Identisch mit der InprocServers-Auflistung, mit dem Ausnahme, dass diese Sammlung auch lokale Server enthält. |
| LocalComputer | Enthält ein einzelnes -Objekt, das Einstellungsinformationen auf Computerebene für den Computer enthält, auf den Sie zugreifen. |
| MethodsForInterface | Enthält ein -Objekt für jede Methode auf der Schnittstelle, mit der die Auflistung verknüpft ist. |
| Partitionen | Wird verwendet, um die anwendungen anzugeben, die in jeder Partition enthalten sind. |
| PartitionUsers | Wird verwendet, um die in jeder Partition enthaltenen Benutzer anzugeben. |
| Propertyinfo | Ruft Informationen zu den Eigenschaften ab, die von einer angegebenen Auflistung unterstützt werden. |
| PublisherProperties | Enthält ein -Objekt für jede Herausgebereigenschaft für die übergeordnete SubscriptionsForComponent-Auflistung. |
| RelatedCollectionInfo | Ruft Informationen zu anderen Auflistungen ab, die mit der Auflistung verknüpft sind, aus der sie aufgerufen wird. |
| Rollen | Enthält ein -Objekt für jede Rolle, die der Anwendung zugewiesen ist, mit der sie verknüpft ist. |
| RolesForComponent | Enthält ein -Objekt für jede Rolle, die der Komponente zugewiesen ist, mit der die Auflistung verknüpft ist. |
| RolesForInterface | Enthält ein -Objekt für jede Rolle, die der Schnittstelle zugewiesen ist, mit der die Auflistung verknüpft ist. |
| RolesForMethod | Enthält ein -Objekt für jede Rolle, die der Methode zugewiesen ist, mit der die Auflistung verknüpft ist. |
| RolesForPartition | Enthält ein -Objekt für jede Rolle, die der Partition zugewiesen ist, mit der die Auflistung verknüpft ist. |
| Wurzel | Enthält die Auflistungen der obersten Ebene im Katalog. |
| SubscriberProperties | Enthält ein -Objekt für jede Abonnenteneigenschaft für die übergeordnete SubscriptionsForComponent-Auflistung. |
| SubscriptionsForComponent | Enthält ein -Objekt für jedes Abonnement für die übergeordnete Components-Auflistung. |
| TransientPublisherProperties | Enthält ein -Objekt für jede Herausgebereigenschaft für die übergeordnete TransientSubscriptions-Auflistung. |
| TransientSubscriberProperties | Enthält ein -Objekt für jede Abonnenteneigenschaft für die übergeordnete TransientSubscriptions-Auflistung. |
| TransientSubscriptions | Enthält ein -Objekt für jedes vorübergehende Abonnement. |
| UsersInPartitionRole | Enthält ein -Objekt für jeden Benutzer in der Partitionsrolle, mit der die Auflistung verknüpft ist. |
| UsersInRole | Enthält ein -Objekt für jeden Benutzer in der Rolle, mit der die Auflistung verknüpft ist. |
| WOWInprocServers | Enthält eine Liste der Prozessserver, die beim System für 32-Bit-Komponenten auf 64-Bit-Computern registriert sind. |
| WOWLegacyServers | Identisch mit der LegacyServers-Sammlung, außer dass diese Auflistung aus der 32-Bit-Registrierung auf 64-Bit-Computern gezeichnet wird. |