Obtention et définition des propriétés (services de composants)
Avant de pouvoir lire ou écrire des propriétés particulières exposées par un élément d’une collection, vous devez effectuer les étapes suivantes :
- Récupérez la collection.
- Remplissez la collection pour qu’elle lise les données à partir du catalogue COM+.
- Récupérez l’élément spécifique de la collection, en le représentant avec un objet de la classe COMAdminCatalogObject .
Pour obtenir un exemple illustrant ces étapes, consultez Navigation dans la hiérarchie de collection COM+.
Étant donné que les propriétés particulières exposées peuvent varier en fonction de ce que l’élément représente ; autrement dit, un élément représentant un composant a des propriétés différentes d’un élément représentant une application COM+. Définissez l’une de ces propriétés à l’aide d’une seule propriété générique, la propriété Value, sur COMAdminCatalogObject.
La propriété Value vous permet d’obtenir ou de définir une propriété nommée spécifique exposée par un élément, de retourner une valeur pour une propriété nommée lors de l’obtention et de prendre un nom et une valeur lors de la définition.
Aucune modification n’est réellement enregistrée dans le catalogue COM+ tant que vous n’avez pas explicitement enregistré les modifications à l’aide de la méthode SaveChanges sur l’objet COMAdminCatalogCollection . Les modifications en attente pour toutes les propriétés de tous les éléments d’une collection donnée sont enregistrées en même temps. Pour plus d’informations, consultez Enregistrement ou abandon des modifications.
Toutes les modifications que vous apportez ne seront pas acceptées. Le catalogue COM+ applique une logique de cohérence pour vous assurer que vous configurez les éléments de manière raisonnable. En outre, lorsque vous modifiez certaines propriétés, d’autres peuvent changer automatiquement par la même logique de cohérence. Ces effets s’affichent lorsque vous tentez d’enregistrer les modifications.
Notes
Il est possible que vous soyez en conflit avec un autre writer dans le catalogue COM+. Entre les appels à Populate et SaveChanges pour une collection donnée, vous n’avez pas de verrou sur ces données dans le catalogue. Plusieurs parties peuvent simultanément configurer des éléments d’une collection donnée et se disputer lorsqu’elles enregistrent les modifications. Cela signifie qu’une autre personne peut modifier les paramètres d’un objet avant ou après l’exécution d’un programme à l’aide des objets COMAdmin ou à l’aide de l’outil d’administration Component Services, localement ou à distance. La règle générale avec l’écriture d’objets dans le catalogue est que toutes les propriétés d’un objet sont écrites à la fois. Autrement dit, le dernier writer gagne : l’objet est enregistré dans le catalogue précisément comme le dernier writer l’a configuré.
Rubriques connexes