Platform SDK: COM+ (Component Services)

COMAdminCatalogCollection Object

The COMAdminCatalogCollection object is a generic object used to represent any collection on the COM+ catalog. Use it to enumerate, add, remove, and retrieve items in a collection, and to access related collections. This object implements the ICatalogCollection interface.

Remarks

You use the COMAdminCatalogCollection object when you want to programmatically manipulate a collection on the COM+ catalog. These collections correspond to folders seen in the Component Services administration tool.

Items inside the folders correspond to items in collections, which you can represent using the COMAdminCatalogObject object.

For information regarding the collections on the catalog and their properties see Administration Collections.

For an introduction to programmatic administration of COM+, see Automating COM+ Administration.

For information on the properties exposed by the COMAdminCatalogCollection object, see ICatalogCollection Properties.

The COMAdminCatalogCollection object implements the ICatalogCollection interface, and provides the following methods.

Methods Description
Add Adds an item to the collection, and returns it as a COMAdminCatalogObject object.
GetCollection Retrieves a related collection, and returns it as a COMAdminCatalogCollection object.
Populate Reads in data from the catalog data store for all objects in the collection.
Remove Removes an item from the collection given its index, and reindexes all items with higher indices.
SaveChanges Saves pending changes made to the collection and any of its items to the catalog data store.