Kolekcje administracyjne COM+

Kolekcje administracyjne COM+ służą do przechowywania i organizowania danych konfiguracji przechowywanych w katalogu COM+. Kolekcje odpowiadają folderom w drzewie konsoli narzędzia administracyjnego usługi składników. Dostęp do tych kolekcji można uzyskać przy użyciu obiektów i interfejsów administracyjnych COM+.

Administrowanie programowe jest inicjowane przy użyciu obiektów utworzonych na podstawie klasy COMAdminCatalog. Wszystkie kolekcje w wykazie są reprezentowane przy użyciu obiektów utworzonych na podstawie klasy COMAdminCatalogCollection i reprezentujesz elementy w kolekcjach przy użyciu obiektów utworzonych na podstawie klasy COMAdminCatalogObject.

Elementy w danej kolekcji uwidaczniają spójny zestaw właściwości. Na przykład każdy element w kolekcji Components reprezentuje składnik, a elementy w kolekcji Components uwidaczniają te same właściwości używane do konfigurowania składnika. Dostęp do tych właściwości można uzyskać przy użyciu klasy COMAdminCatalogObject.

Nuta

Właściwości z dostępem writeOnce są readWrite podczas korzystania z metody Add przed użyciem SaveChanges i są później readOnly.

 

Aby zapoznać się z wprowadzeniem do programowego administrowania com+, zobacz Automatyzowanie administracji COM+.

Hierarchia kolekcji

Na poniższej ilustracji przedstawiono relacje między kolekcjami. Kolekcje po lewej stronie (w białych i szarych polach) to kolekcje najwyższego poziomu, do których uzyskuje się dostęp, wywołując metodę GetCollection obiektu utworzonego na podstawie klasy COMAdminCatalog. Pozostałe kolekcje (w żółtych polach) można uzyskać tylko za pośrednictwem kolekcji nadrzędnej, wywołując metodę GetCollection obiektu COMAdminCatalogCollection reprezentującego ich obiekt nadrzędny. Strzałki wskazują z kolekcji nadrzędnej na jej kolekcje podrzędne.

Na rysunku nie przedstawiono następujących czterech kolekcji: ErrorInfo, PropertyInfo, RelatedCollectionInfoi Root. Kolekcja ErrorInfo jest elementem podrzędnym każdej kolekcji na rysunku, z wyjątkiem InprocServers i WOWInprocServers (w szarych polach). Kolekcje PropertyInfo i RelatedCollectionInfo są elementami podrzędnymi każdej kolekcji. Kolekcja Root to kolekcja najwyższego poziomu, która jest elementem nadrzędnym wszystkich innych kolekcji najwyższego poziomu. Jednak nie jest konieczne uzyskanie dostępu do kolekcji głównej przed uzyskaniem dostępu do innych kolekcji najwyższego poziomu.

Biblioteka COMAdmin

Następujące kolekcje są obsługiwane przez bibliotekę COMAdmin.

Kolekcja	Opis
ApplicationCluster	Zawiera listę serwerów w klastrze aplikacji.
ApplicationInstances	Zawiera obiekt dla każdego wystąpienia uruchomionej aplikacji COM+.
Applications	Zawiera obiekt dla każdej aplikacji COM+ zainstalowanej na komputerze lokalnym.
składników	Zawiera obiekt dla każdego składnika w aplikacji, z którym jest powiązany.
ComputerList	Zawiera listę komputerów znajdujących się w folderze Computers narzędzia administracyjnego usługi składników.
DCOMProtocols	Zawiera listę protokołów, które mają być używane przez model DCOM. Zawiera on obiekt dla każdego protokołu.
ErrorInfo	Pobiera rozszerzone informacje o błędach dotyczące metod, które zajmują się wieloma obiektami.
EventClassesForIID	Pobiera informacje dotyczące klas zdarzeń.
FilesForImportuj	Pobiera informacje z pliku MSI o aplikacji, którą można zaimportować.
InprocServers	Zawiera listę serwerów przetwarzania zarejestrowanych w systemie. Zawiera on obiekt dla każdego składnika.
interfejsy ForComponent	Zawiera obiekt dla każdego interfejsu uwidocznionego przez składnik, z którym jest powiązana kolekcja.
LegacyComponents	Zawiera obiekt dla każdego nieskonfigurowanego składnika w aplikacji, z którym jest powiązany.
LegacyServers	Identyczne z kolekcją InprocServers z tą różnicą, że ta kolekcja zawiera również serwery lokalne.
LocalComputer	Zawiera pojedynczy obiekt, który zawiera informacje o ustawieniach na poziomie komputera, którego wykaz uzyskujesz dostęp.
MethodsForInterface	Zawiera obiekt dla każdej metody w interfejsie, z którym jest powiązana kolekcja.
Partitions	Służy do określania aplikacji zawartych w każdej partycji.
PartitionUsers	Służy do określania użytkowników zawartych w każdej partycji.
PropertyInfo	Pobiera informacje o właściwościach, które obsługuje określona kolekcja.
PublisherProperties	Zawiera obiekt dla każdej właściwości wydawcy dla kolekcji nadrzędnej subskrypcjiForComponent.
RelatedCollectionInfo	Pobiera informacje o innych kolekcjach powiązanych z kolekcją, z której jest wywoływana.
ról	Zawiera obiekt dla każdej roli przypisanej do aplikacji, do której jest ona powiązana.
role W przypadku component	Zawiera obiekt dla każdej roli przypisanej do składnika, do którego jest powiązana kolekcja.
RolesForInterface	Zawiera obiekt dla każdej roli przypisanej do interfejsu, do którego jest powiązana kolekcja.
role ForMethod	Zawiera obiekt dla każdej roli przypisanej do metody, do której jest powiązana kolekcja.
RolesForPartition	Zawiera obiekt dla każdej roli przypisanej do partycji, do której jest powiązana kolekcja.
root	Zawiera kolekcje najwyższego poziomu w wykazie.
SubskrybentWłaściwości	Zawiera obiekt dla każdej właściwości subskrybenta dla kolekcji nadrzędnej subscriptionsForComponent.
SubscriptionsForComponent	Zawiera obiekt dla każdej subskrypcji kolekcji Components nadrzędnej.
TransientPublisherProperties	Zawiera obiekt dla każdej właściwości wydawcy dla kolekcji nadrzędnych transientSubscriptions.
TransientSubscriberProperties	Zawiera obiekt dla każdej właściwości subskrybenta dla kolekcji nadrzędnych transientSubscriptions.
transientSubscriptions	Zawiera obiekt dla każdej subskrypcji przejściowej.
UsersInPartitionRole	Zawiera obiekt dla każdego użytkownika w roli partycji, z którą jest powiązana kolekcja.
UsersInRole	Zawiera obiekt dla każdego użytkownika w roli, z którą jest powiązana kolekcja.
WOWInprocServers	Zawiera listę serwerów przetwarzania zarejestrowanych w systemie dla składników 32-bitowych na komputerach 64-bitowych.
WOWLegacyServers	Identyczne z kolekcją LegacyServers z tą różnicą, że ta kolekcja jest pobierana z rejestru 32-bitowego na komputerach 64-bitowych.