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.
Notes
Avant de créer ou d’exécuter l’un des exemples WCF, assurez-vous d’avoir effectué la procédure d’installation unique pour les exemples Windows Communication Foundation.
Pour exécuter l'exemple sur le même ordinateur
Si le service est hébergé par IIS, vérifiez son accessibilité à l’aide d’un navigateur en tapant l’adresse suivante :
http://localhost/servicemodelsamples/service.svc. Une page de confirmation doit s'afficher en réponse. Si la page de confirmation n’est pas affichée, consultez Conseils de résolution des problèmes pour les exemples WCF.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.
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.
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
Si le service est hébergé par IIS :
Créez un répertoire virtuel nommé ServiceModelSamples sur l'ordinateur de service. Le fichier batch Setupvroot.bat de la Procédure d’installation unique pour les exemples Windows Communication Foundation peut être utilisé pour créer le répertoire disque et le répertoire virtuel.
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.
Assurez-vous que le service est accessible depuis l'ordinateur du client en utilisant un navigateur.
Si le service est auto-hébergé :
Sur l'ordinateur du service, créez un répertoire afin d'y stocker les fichiers lui correspondant.
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.
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.
Lancez Service.exe depuis une invite de commandes.
Copiez les fichiers programme du client du dossier \client\bin\ (situé dans le dossier correspondant à votre langue) sur l’ordinateur client.
Définissez l'adresse de point de terminaison.
Si le service ne s'exécute pas sous un compte de domaine, ouvrez le fichier de configuration du client, puis modifiez l'adresse du 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.
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 Création des exemples Windows Communication Foundation. Utilisez le fichier généré au lieu du fichier de configuration utilisé 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 à la connexion au point de terminaison du service bien qu'il s'agisse de paramètres par défaut. Pour plus d’informations sur les informations d’identité, consultez Identité et authentification du service et <identité>.
Sur l'ordinateur client, lancez Client.exe à partir d'une invite de commandes.
Pour déboguer un service
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.
Si le service est hébergé par IIS :
Activez le service à l’aide d’un navigateur en entrant l’adresse
http://localhost/servicemodelsamples/service.svc.Dans la solution, choisissez le menu Débogage, puis l’élément de menu Attacher au processus.
Cochez la case Afficher les processus de tous les utilisateurs.
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).
Vous pouvez à présent définir des points d'arrêt dans le code de service et activer ces points pour les exceptions.
Cliquez avec le bouton droit sur l'élément de projet client, puis sélectionnez Débogage, 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).