Partager via


Exécution des exemples Windows Communication Foundation

Les exemples Windows Communication Foundation (WCF) peuvent être exécutés dans une configuration à machine unique ou inter-ordinateurs. Comme indiqué, les exemples sont prêts à s’exécuter sur un seul ordinateur. Dans une configuration inter-ordinateur, il est nécessaire de modifier les paramètres de fichier de configuration d’un exemple. Les procédures suivantes expliquent comment exécuter un exemple dans des configurations identiques et entre machines. Notez qu’il existe des variations dans les étapes des services hébergés dans Internet Information Services (IIS) et les exemples auto-hébergés. La plupart des exemples sont hébergés dans IIS ; consultez les exemples d’informations lisez-moi pour déterminer comment il est hébergé.

Sur Windows Vista, les exemples qui ne sont pas hébergés dans IIS nécessitent des privilèges élevés pour inscrire un écouteur auprès de Http.sys. Utilisez Httpcfg.exe pour inscrire les adresses d’écoute du service auprès du compte sous lequel le service s’exécute ou lancer le service à partir d’une invite de commandes exécutée avec des privilèges d’administrateur.

Remarque

Avant de générer ou d’exécuter l’un des exemples WCF, assurez-vous d’avoir effectué la procédure d’installationOne-Time 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 que vous pouvez accéder au service à l’aide d’un navigateur en entrant l’adresse suivante : http://localhost/servicemodelsamples/service.svc Une page de confirmation doit être affichée en réponse. Si la page de confirmation n’est pas affichée, consultez conseils de dépannage pour les exemples WCF.

  2. Si le service est auto-hébergé, exécutez Service.exe à partir de \service\bin, sous le dossier spécifique à la langue. L’activité de service s’affiche dans la fenêtre de console de service.

  3. Exécutez Client.exe à partir de \client\bin\, sous le dossier spécifique à la langue. L’activité du client s’affiche dans la fenêtre de la console cliente.

  4. Si le client et le service ne sont pas en mesure de communiquer, consultez Conseils de résolution des problèmes pour les exemples WCF.

Pour exécuter l’exemple sur plusieurs ordinateurs

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

    1. Sur la machine de service, créez un répertoire virtuel nommé ServiceModelSamples. Le fichier batch Setupvroot.bat inclus avec One-Time procédure d’installation pour les exemples Windows Communication Foundation peut être utilisé pour créer le répertoire de disque et le répertoire virtuel.

    2. Copiez les fichiers de programme de service à partir de %SystemDrive%\Inetpub\wwwroot\servicemodelsamples vers le répertoire virtuel ServiceModelSamples sur la machine de service. Vérifiez que vous incluez les fichiers dans le répertoire \bin.

    3. Testez que vous pouvez accéder au service à partir de l’ordinateur client à l’aide d’un navigateur.

    Si le service est auto-hébergé :

    1. Sur l’ordinateur de service, créez un répertoire pour contenir les fichiers de service.

    2. Copiez les fichiers de programme de service à partir du dossier \service\bin\, sous le dossier spécifique à la langue, sur l’ordinateur de service.

    3. Dans le fichier de configuration du service, modifiez la valeur d’adresse de la définition de point de terminaison pour qu’elle corresponde à la nouvelle adresse de votre service. Remplacez toutes les références à « localhost » par un nom de domaine complet dans l’adresse.

    4. Lancez Service.exe à partir d’une invite de commandes.

  2. Copiez les fichiers de programme client à partir du dossier \client\bin\, sous le dossier spécifique à la langue, sur l’ordinateur client.

  3. Définissez l’adresse du point de terminaison.

    1. Si le service n’est pas en cours d’exécution sous un compte de domaine, ouvrez le fichier de configuration du client et modifiez la valeur d’adresse de la définition de point de terminaison pour qu’elle corresponde à la nouvelle adresse de votre service. Remplacez toutes les références à « localhost » par un nom de domaine complet dans l’adresse.

    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 sur le 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 du fichier de configuration dans l’exemple. Le fichier de configuration généré contient des informations d’identité supplémentaires et contient tous les paramètres nécessaires pour se connecter au point de terminaison de service, même s’ils sont les paramètres par défaut. Pour plus d’informations sur les informations d’identité, consultez Identité et authentification du service et <identité>.

  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 client et service) à l’aide du menu Build ou de Ctrl+Maj+B.

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

    1. Activez le service à l’aide d’un navigateur en entrant l’adresse http://localhost/servicemodelsamples/service.svc.

    2. Dans la solution, choisissez le menu Déboguer et l’élément de menu Attacher au processus .

    3. Activez la case à cocher Afficher les processus à partir de tous les utilisateurs .

    4. Sélectionnez le processus de travail hôte W3wp.exe pour déboguer (sélectionnez ASPNet_wp.exe sur Windows XP).

  3. Vous pouvez maintenant définir des points d’arrêt dans le code de service et activer des points d’arrêt sur des exceptions.

  4. Cliquez avec le bouton droit sur l’élément de projet client et choisissez Déboguer, Démarrer une nouvelle instance.

Pour nettoyer après le test

  • Si le service est hébergé dans IIS à des fins de sécurité, supprimez la définition de répertoire virtuel et les autorisations accordées dans les étapes d’installation lorsque vous avez terminé avec les exemples.

Voir aussi