Exécution des exemples Windows Communication Foundation

Les exemples Windows Communication Foundation (WCF) peuvent être exécutés sur un ou plusieurs ordinateurs. Tels qu'ils sont fournis, les exemples sont configurés pour être exécutés sur un ordinateur unique. Pour les exécuter sur plusieurs ordinateurs, il est nécessaire de modifier les paramètres de leur fichier de configuration. Les procédures suivantes permettent d'exécuter les exemples sur un même ordinateur ou sur plusieurs ordinateurs. Notez que ces procédures ne sont pas tout à fait les mêmes pour les exemples hébergés dans les services IIS et les exemples auto-hébergés. La plupart des exemples sont hébergés dans les services IIS. Consultez les informations contenues dans leur fichier lisezmoi respectif pour connaître leurs modalités d'hébergement.

Sur Windows Vista, les exemples non hébergés dans les services IIS nécessitent l'utilisation de droits d'administrateur pour permettre l'enregistrement d'un écouteur à l'aide de Http.sys. Utilisez Httpcfg.exe pour enregistrer les adresses d'écoute du service à l'aide du compte sous lequel le service s'exécute, ou lancez ce même service depuis une invite de commandes s'exécutant sous un compte d'administrateur.

Remarque :
Avant de générer ou d'exécuter l'un des exemples WCF, assurez d'avoir effectué la procédure figurant à la section Procédure d'installation unique pour les exemples Windows Communication Foundation.

Pour exécuter l'exemple sur le même ordinateur

1. Si le service est hébergé par IIS, vérifiez son accessibilité à l'aide d'un navigateur en tapant https://localhost/servicemodelsamples/service.svc dans un navigateur. Une page de confirmation doit s'afficher en réponse. Dans le cas contraire, consultez Conseils de dépannage.

2. Si le service est auto-hébergé, exécutez Service.exe à partir du répertoire \service\bin, situé dans le dossier correspondant à votre langue. L'activité du service s'affiche dans sa fenêtre de console.

3. Exécutez Client.exe à partir du dossier \client\bin\ figurant dans le dossier correspondant à votre langue. L'activité du client s'affiche dans sa fenêtre de console.

4. Si le client et le service ne parviennent pas à communiquer, consultez Conseils de dépannage.

Pour exécuter l'exemple sur plusieurs ordinateurs

1. Si le service est hébergé par IIS :

   1. Créez un répertoire virtuel nommé ServiceModelSamples sur l'ordinateur de service. Le fichier de commandes Setupvroot.bat contenu dans Procédure d'installation unique pour les exemples Windows Communication Foundation permet de créer le répertoire de disque et le répertoire virtuel.
   2. Copiez les fichiers du programme de service depuis %SystemDrive%\Inetpub\wwwroot\servicemodelsamples vers le répertoire virtuel ServiceModelSamples. Assurez-vous de copier les fichiers dans le répertoire \bin.
   3. Assurez-vous que le service est accessible depuis l'ordinateur du client en utilisant un navigateur.

   Si le service est auto-hébergé :

   1. Sur l'ordinateur du service, créez un répertoire afin d'y stocker les fichiers lui correspondant.
   2. Copiez les fichiers de programme du service figurant dans le dossier \service\bin\ (situé dans le dossier correspondant à votre langue) sur l'ordinateur de service.
   3. Dans le fichier de configuration du service, modifiez l'adresse de la définition du point de terminaison afin qu'elle corresponde à la nouvelle adresse de votre service. Remplacez toutes les occurrences de « localhost » de l'adresse par un nom de domaine complet.
   4. Lancez Service.exe depuis une invite de commandes.

2. Copiez les fichiers programme du client du dossier \client\bin\ (situé dans le dossier correspondant à votre langue) sur l'ordinateur client.

3. Définissez l'adresse de point de terminaison.

   1. Si le service ne s'exécute pas sous un compte de domaine, ouvrez le fichier de configuration du client, puis modifiez l'adresse de point de terminaison en fonction de la nouvelle adresse de votre service. Remplacez toutes les occurrences de « localhost » de l'adresse par un nom de domaine complet.
   2. Si le service s'exécute sous un compte de domaine, régénérez la configuration du client en exécutant Svcutil.exe par rapport au service. Pour plus d'informations sur l'exécution de Svcutil.exe, consultez Génération des exemples Windows Communication Foundation. Utilisez le fichier généré au lieu d'utiliser le fichier de configuration figurant dans l'exemple. Le fichier de configuration généré contient des informations d'identité supplémentaires ainsi que tous les paramètres permettant de se connecter au point de terminaison de service bien qu'il s'agisse de paramètres par défaut. Pour plus d'informations sur les informations d'identité, consultez Service Identity and Authentication et <identity>.

4. Sur l'ordinateur client, lancez Client.exe à partir d'une invite de commandes.

Pour déboguer un service

1. Générez la solution (à la fois pour le client et le service) à l'aide du menu Génération ou des touches CTRL+MAJ+B de votre clavier.

2. Si le service est hébergé par IIS :

   1. Activez le service à l'aide d'un navigateur en tapant https://localhost/servicemodelsamples/service.svc.
   2. Dans la solution, choisissez le menu Débogage, puis l'élément de menu Attacher au processus.
   3. Activez la case à cocher Afficher les processus de tous les utilisateurs.
   4. Sélectionnez le processus de traitement W3wp.exe hôte afin de procéder au débogage (sélectionnez ASPNet_wp.exe sur Windows XP).

3. Vous pouvez à présent définir des points d'arrêt dans le code de service et activer ces points pour les exceptions.

4. Cliquez avec le bouton droit sur l'élément de projet client, puis sélectionnez Débogage et Démarrer une nouvelle instance.

Pour procéder au nettoyage après exécution de l'exemple

• Si le service est hébergé par IIS, pour des raisons de sécurité, supprimez la définition du répertoire virtuel ainsi que les autorisations accordées au cours des étapes d'installation (une fois l'exécution des exemples terminée).

Voir aussi

Concepts

Génération des exemples Windows Communication Foundation
Exécution des exemples dans un groupe de travail et sur plusieurs ordinateurs

Autres ressources

Conseils de dépannage

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.