Esplorazione della gerarchia di raccolte COM+
Alcune raccolte è possibile recuperare facilmente usando il metodo GetCollection nell'oggetto COM Amministrazione Catalog. Questo metodo recupera una raccolta di primo livello; ovvero una raccolta, ad esempio Applications, che si trova autonomamente e che è univoca e non logicamente sottosumibile in un'altra raccolta.
Molte raccolte, tuttavia, sono logicamente sottosumate in un'altra raccolta perché contengono elementi che fanno parte di una struttura più grande. Ad esempio, l'insieme Components è sottosumed o correlato all'insieme Applications perché contiene i componenti installati in una particolare applicazione COM+, che corrisponde a un elemento dell'insieme Applications. Le raccolte correlate, ad esempio queste, non sono univoche; è disponibile una raccolta Components per ogni applicazione distinta.
Pertanto, le raccolte vengono disposte in una struttura gerarchica che corrisponde naturalmente alle relazioni logiche tra gli elementi che contengono. Un diagramma della gerarchia di raccolte è disponibile in COM+ Amministrazione istration Collections. Per molti degli elementi da configurare usando gli oggetti COM Amministrazione, è necessario spostarsi tra alcune parti della gerarchia di raccolta per recuperare l'elemento appropriato.
Ciò significa che in pratica, se si vuole ottenere un elemento in una raccolta correlata, è necessario esaminare prima tutte le raccolte di livello superiore necessarie. Per recuperare una raccolta correlata, è necessario recuperare l'elemento specifico nella raccolta padre a cui è correlata la raccolta figlio. Ad esempio, se si vuole configurare un elemento corrispondente a un componente in una particolare applicazione COM+, è necessario eseguire la procedura seguente:
- Ottenere la raccolta Applications e popolarla.
- Enumerare il contenuto dell'insieme Applications finché non si arriva all'elemento corrispondente all'applicazione COM+ corretta.
- Ottiene e popola la raccolta Components per quella particolare applicazione COM+.
- Enumerare il contenuto dell'insieme Components finché non si arriva all'elemento corrispondente al componente corretto.
Nell'esempio seguente di Microsoft Visual Basic viene illustrato come eseguire i passaggi precedenti:
On Error GoTo My_Error_Handler
Dim Catalog As COMAdminCatalog
Set Catalog = CreateObject("COMAdmin.COMAdminCatalog")
' Get the Applications collection and populate it.
Dim Applications As COMAdminCatalogCollection
Set Applications = Catalog.GetCollection("Applications")
Applications.Populate
' Get the correct application, "My Application".
Dim AppObject As COMAdminCatalogObject
For Each AppObject in Applications
If AppObject.Name = "My Application" Then
Exit For
End If
Next
' Get and populate the Components collection for "My Application".
Dim Components As COMAdminCatalogCollection
Set Components = Applications.GetCollection("Components", AppObject.Key)
Components.Populate
' Get the correct component, "My Component".
Dim CompObject As COMAdminCatalogObject
For Each CompObject in Components
If CompObject.Name = "My Component" Then
Exit For
End If
Next
Nell'esempio precedente vengono usati due metodi GetCollection distinti. Il primo viene esposto da COM Amministrazione Catalog e viene usato per ottenere una raccolta di primo livello, in questo caso "Applications". Il secondo viene esposto da COM Amministrazione CatalogCollection e viene utilizzato per ottenere una raccolta correlata all'insieme presente. È possibile indicare esattamente quale raccolta si desidera passare il nome "Components" e il valore della proprietà Key dell'oggetto padre. Il valore della proprietà Key è spesso un nome o un GUID che identifica in modo univoco l'oggetto; questo valore viene identificato nella documentazione per ogni raccolta.
Nel caso più generale, è necessario ottenere le raccolte correlate in modo iterativo verso il basso nella gerarchia di raccolta fino a quando non si recupera la raccolta desiderata. I passaggi da eseguire seguono lo stesso modello generale, ripetitivamente. Per un elenco completo delle raccolte, vedere Raccolte di Amministrazione istration COM+.
In alcuni casi, è possibile usare un metodo di scelta rapida la seconda volta che si segue un percorso attraverso la gerarchia di raccolta. È possibile usare questo metodo solo dopo aver già memorizzato nella cache tutti i valori chiave intermedi. Per informazioni dettagliate, vedere ICOM Amministrazione Catalog::GetCollectionByQuery.
Argomenti correlati