Construction d'objets, exemple de technologie
Mise à jour : novembre 2007
Cet exemple illustre l'utilisation de chaînes de construction d'objets dans un environnement .NET. Les chaînes de construction d'objets sont des chaînes d'initialisation qu'il est possible de définir ou de modifier via l'outil d'administration Services de composants. Dès lors, il n'est plus nécessaire de coder en dur les informations de configuration dans les composants. L'interface utilisateur de l'exemple est un formulaire avec un seul bouton qui crée un objet utilisant des chaînes de construction. Les messages affichent les différentes étapes de l'activation.
Pour plus d'informations sur l'utilisation des exemples, consultez les rubriques suivantes :
Pour générer l'exemple à partir de l'invite de commandes
Ouvrez la fenêtre d'invite de commandes et accédez à l'un des sous-répertoires spécifiques aux différents langages sous le répertoire Technologies\ComponentServices\ObjectConstruction.
Tapez msbuild ObjectConstructionCS.sln ou msbuild ObjectConstructionVB.sln, selon votre choix de langage de programmation.
Pour générer l'exemple à l'aide de Visual Studio
Ouvrez l'Explorateur Windows et accédez à l'un des sous-répertoires spécifiques aux différents langages sous le répertoire Technologies\ComponentServices\ObjectConstruction.
Double-cliquez sur l'icône de ObjectConstructionCS.sln ou ObjectConstructionVB.sln, selon votre choix de langage de programmation, pour ouvrir le fichier dans Visual Studio.
Dans le menu Générer, cliquez sur Générer la solution.
Pour exécuter l'exemple
Ouvrez une fenêtre d'invite de commandes ou l'Explorateur Windows et accédez au répertoire qui contient le fichier exécutable généré.
Tapez OCDemo.exe sur la ligne de commande ou démarrez le fichier exécutable en double-cliquant sur celui-ci dans l'Explorateur Windows. N'oubliez pas de noter la version de l'exemple d'application que vous exécutez (C# dans le sous-répertoire \CS ou Visual Basic dans le sous-répertoire \VB) dans la mesure où ceci détermine les attributs de composant COM+ que vous devez modifier lors d'une étape ultérieure.
Lorsque le programme démarre, cliquez sur le bouton Créer un objet. Un message apparaît à chaque étape d'activation. Notez la valeur de chaîne de construction d'objet indiquée dans l'appel à IObjectConstruct::Construct.
Démarrez l'outil d'administration Services de composants en cliquant sur Démarrer- > Tous les programmes - > Outils d'administration - > Services de composants et recherchez l'application COM+ OCDemoSvr en développant Services de composants\Ordinateurs\Poste de travail\Applications COM+ dans le volet gauche de l'Explorateur COM+.
Recherchez le composant Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest en développant OCDemoSvr\Components.
Cliquez avec le bouton droit sur le composant ObjectConstructionTest et sélectionnez Propriétés dans le menu contextuel.
Cliquez sur l'onglet Activation et introduisez une nouvelle valeur texte dans le champ d'édition de la chaîne du constructeur. Cliquez sur OK pour accepter les modifications.
Retournez à l'application OCDemo et cliquez à nouveau sur Créer un objet. Notez la nouvelle valeur transmise par la méthode IObjectConstruct (elle doit correspondre à la chaîne récemment modifiée dans la page des propriétés du composant Explorateur COM+).
Pour désinstaller l'exemple
Accédez au répertoire dans lequel vous avez exécuté msbuild.exe ou ouvert le fichier .sln.
Tapez msbuild.exe ObjectConstructionVB.sln /t:Clean ou msbuild.exe ObjectConstructionCS.sln /t:Clean sur la ligne de commande, selon votre choix de langage de programmation. Cette commande appelle Outil .NET Services Installation Tool (Regsvcs.exe) et Outil Global Assembly Cache Tool (Gacutil.exe) avec le commutateur /u pour supprimer les fichiers d'exemple du catalogue COM+ et du Global Assembly Cache.
Configuration requise
plateformes : Windows 2000, Windows XP, Windows Server 2003
Version .NET Framework : 2.0, 1.1, 1.0
Notes
Pour plus d'informations sur les étapes de création et d'inscription d'exemples de fichiers binaires, consultez les commentaires figurant dans le code source et dans les fichiers build.proj.
Cette procédure montre comment créer un composant COM+ en ayant activé la construction d'objets et en utilisant une chaîne de construction par défaut. Au moment de la création d'une instance d'objet, plusieurs méthodes de composant affichent des messages afin de montrer l'ordre d'appel. Vous modifiez la chaîne de construction d'objet à l'aide de l'outil d'administration Services de composants et vous réexécutez l'exemple pour observer la modification de la chaîne de construction d'objet passée à l'instance du composant.
.gif "Remarque") Remarque : |
|---|
Vous devez utiliser Outil Global Assembly Cache Tool (Gacutil.exe) pour installer l'assembly OCDemoSvr.dll dans le Global Assembly Cache avant d'exécuter l'exemple. Gacutil.exe figure dans le répertoire SDK<version>\Bin. Par exemple, si vous avez généré la version Visual Basic de l'exemple, accédez au répertoire C:\Documents and Settings\Votre nom d'utilisateur\Mes documents\Samples\Technologies\ComponentServices\ObjectConstruction\VB et tapez gacutil - i OCDemoSvr.dll. |
Le nom du composant tel qu'il apparaît dans l'outil d'administration Services de composants est Microsoft.Samples.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest.
Lorsque la construction d'objet est activée pour un composant, COM+ appelle et implémente immédiatement la méthode IObjectContruct::Construct après avoir créé une instance de l'objet. La chaîne de construction d'objet spécifiée dans les propriétés d'activation du composant est passée en tant qu'argument à la méthode. Par son association au code du composant qui utilise correctement la chaîne d'objet, vous obtenez alors la construction d'objet paramétrée.
Vous pouvez spécifier une valeur de chaîne par défaut pour la chaîne de construction dans la propriété Default de ConstructionEnabledAttribute, dans le catalogue COM+, ou dans les deux.
Un développeur de composants peut utiliser cette fonctionnalité, par exemple, pour écrire un composant qui détient une connexion ODBC générique. La chaîne de construction d'objet contient alors un nom de source de données (DSN) précis, qu'il est possible de modifier via l'outil d'administration Services de composants.
Il peut être utile de combiner les chaînes de construction d'objet avec les services de pool d'objets COM+.
Voir aussi
Concepts
Utilisation de types COM dans du code managé
Référence
Outil Global Assembly Cache Tool (Gacutil.exe)