Étape 9 : Générer et déployer l’adaptateur Echo

Article
07/21/2023

Étape 9 sur 9

Durée d’exécution : 10 minutes

Dans cette étape, vous allez effectuer les tâches nécessaires pour déployer l’adaptateur Echo. Cela implique tous les éléments suivants :

Créer un fichier de nom fort et l’affecter à l’assembly de l’adaptateur Echo
Générer l’adaptateur Echo
Publier l’assembly dans le GAC
Inscrire l’adaptateur Echo auprès de Windows Communication Foundation (WCF)

Prérequis

Pour réussir cette étape, vous devez être familiarisé avec les fichiers de noms forts et le GAC. Une compréhension de base de la configuration de Windows Communication Foundation (WCF) est utile, mais pas obligatoire.

Pour affecter un nom fort à votre assembly

Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet EchoAdapter, puis cliquez sur Propriétés.
Dans la boîte de dialogue Pages de propriétés EchoAdapter, sélectionnez Signature dans le volet gauche.
Cliquez sur l’onglet Signer l’assembly .
Choisissez <nouveau...> pour le fichier de nom fort. Lorsque vous êtes invité à entrer un nom de fichier, tapez EchoAdapter.snk, désélectionnez l’option Protéger mon fichier de clé avec un mot de passe, puis cliquez sur OK.
Cliquez sur l’onglet Application .
Remplacez le nom de l’assembly par Microsoft.Adapters.Samples.EchoV2.
Cliquez sur Fichier dans le menu Visual Studio, puis choisissez Enregistrer tout.

Pour générer et déployer l’adaptateur Echo

Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet EchoAdapter, puis cliquez sur Générer. Si la génération échoue, corrigez les erreurs et essayez de reconstruire l’adaptateur Echo.
Ouvrez une invite de commandes de Visual Studio.
Tapez la commande suivante :

gacutil.exe /if »<chemin d’accès à assembly\Microsoft.Adapters.Samples.EchoV2.dll>»

Cette procédure installe l'assembly dans le GAC, en remplaçant tout autre assembly existant sous le même nom.

Pour inscrire l’adaptateur Echo auprès de Windows Communication Foundation

Modifiez le fichier machine.config situé dans le dossier de configuration Microsoft .NET. Pour ce faire, cliquez sur Démarrer, sur Exécuter, tapez <chemin> d’installation Windows\Microsoft.NET\Framework\<version>\CONFIG\machine.config, puis cliquez sur OK.

Mettez à jour le fichier machine.config. Si votre machine.config ne contient pas de section system.serviceModel, ajoutez la section suivante à la fin du fichier de configuration, mais avant la balise racine fermante.

Notes

Remplacez la version, la culture, le jeton de clé publique et d’autres informations spécifiques à l’assembly par les informations de votre adaptateur.

<system.serviceModel>  
  <client>  
    <endpoint binding="echoAdapterBindingV2" contract="IMetadataExchange"  
      name="echov2" />  
  </client>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="echoAdapterV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingElementExtensionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
    </bindingElementExtensions>  
    <bindingExtensions>  
      <add name="echoAdapterBindingV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingCollectionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
    </bindingExtensions>  
  </extensions>  
</system.serviceModel>

- OU -

Si votre machine.config contient une section system.serviceModel, déterminez les éléments manquants et ajoutez-les.

Notes

Remplacez la version, la culture, le jeton de clé publique et d’autres informations spécifiques à l’assembly par les informations de votre adaptateur.

<client>  
  <endpoint binding="echoAdapterBindingV2" contract="IMetadataExchange"  
    name="echov2" />  
</client>  
<extensions>  
  <bindingElementExtensions>  
    <add name="echoAdapterV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingElementExtensionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
  </bindingElementExtensions>  
  <bindingExtensions>  
    <add name="echoAdapterBindingV2" type="Microsoft.Adapters.Samples.EchoV2.EchoAdapterBindingCollectionElement,Microsoft.Adapters.Samples.EchoV2, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxxxxxxxxxxxxxxx" />  
  </bindingExtensions>  
</extensions>

Enregistrez le fichier machine.config.

Qu’est-ce que je viens de faire ?

Dans cette dernière étape du didacticiel Sur l’adaptateur Echo, vous avez ajouté un nom fort à l’adaptateur Echo, créé et déployé l’adaptateur, puis modifié Machine.config pour inclure des informations sur l’adaptateur. À ce stade, l’adaptateur Echo doit être disponible pour les applications consommatrices.

Étapes suivantes

Ce tutoriel est terminé. Si vous souhaitez tester la fonctionnalité de l’adaptateur Echo dans un projet .NET, consultez Tutoriel 2 : Consommer l’adaptateur Echo à partir de .NET.

Voir aussi

Étape 8 : Implémenter le gestionnaire de trafic entrant synchrone pour l’adaptateur Echo
Didacticiel 2 : Utiliser l’adaptateur Echo à partir de .NET

Partager via