Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’hôte de service Windows Communication Foundation (WCF) (WcfSvcHost.exe) vous permet de lancer le débogueur Visual Studio (F5) pour héberger et tester automatiquement un service que vous avez implémenté. Vous pouvez ensuite tester le service à l’aide du client de test WCF (WcfTestClient.exe), ou de votre propre client, pour rechercher et corriger les erreurs potentielles.
Hôte de service WCF
L’hôte de service WCF énumère les services d’un projet de service WCF, charge la configuration du projet et instancie un hôte pour chaque service qu’il trouve. L’outil est intégré à Visual Studio via le modèle de service WCF et est appelé lorsque vous commencez à déboguer votre projet.
En utilisant l’hôte de service WCF, vous pouvez héberger un service WCF (dans un projet de bibliothèque de services WCF) sans écrire de code supplémentaire ou valider sur un hôte spécifique pendant le développement.
Remarque
L’hôte de service WCF ne prend pas en charge la confiance partielle. Si vous souhaitez utiliser un service WCF en approbation partielle, n’utilisez pas le modèle de projet de bibliothèque de services WCF dans Visual Studio pour générer votre service. Au lieu de cela, créez un nouveau site web dans Visual Studio en choisissant le modèle WebSite du service WCF, qui peut héberger le service dans un serveur Web sur lequel la confiance partielle WCF est prise en charge.
Types de projet hébergés par l’hôte de service WCF
L’Hôte de service WCF peut héberger les types de projets Bibliothèque du service WCF suivants : Bibliothèque du service WCF, Bibliothèque du service de workflow séquentiel, Bibliothèque du service de workflow de l’ordinateur d’état et Bibliothèque du service de syndication. L’hôte de service WCF peut également héberger ces services qui peuvent être ajoutés à un projet de bibliothèque de services à l’aide de la fonctionnalité Ajouter un élément . Parmi ces services, on compte le service WCF, le service de l’ordinateur d’état WF, le service séquentiel WF, le service de l’ordinateur d’état WF XAML et le service séquentiel WF XAML.
Toutefois, vous devez noter que l’outil ne vous aidera pas à configurer un hôte. Pour cette tâche, vous devez modifier manuellement le fichier App.config. L’outil ne valide pas non plus les fichiers de configuration définis par l’utilisateur.
Avertissement
Vous ne devez pas utiliser l’hôte de service WCF pour héberger des services dans un environnement de production, car il n’a pas été conçu à cet effet. L’hôte de service WCF ne prend pas en charge les exigences de fiabilité, de sécurité et de facilité de gestion d’un tel environnement. Au lieu de cela, utilisez IIS, car il fournit des fonctionnalités de fiabilité et de surveillance supérieures, et est la solution préférée pour les services d’hébergement. Une fois le développement de vos services terminé, vous devez migrer les services de l’hôte de service WCF vers IIS.
Scénarios d’utilisation de l’hôte de service WCF dans Visual Studio
Le tableau suivant répertorie tous les paramètres de la boîte de dialogue Arguments de ligne de commande , qui sont disponibles en cliquant avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, en sélectionnant Propriétés, puis en sélectionnant l’onglet Débogage , puis en cliquant sur Démarrer le projet. Ces paramètres sont utiles pour configurer l’hôte de service WCF.
Paramètre | Sens |
---|---|
/client |
Paramètre facultatif qui spécifie le chemin d’accès à un exécutable à exécuter une fois les services hébergés. Cette opération lance le client de test WCF après l’hébergement. |
/clientArg |
Spécifiez une chaîne en tant qu’argument passé à l’application cliente personnalisée. |
/? |
Affiche le texte d’aide. |
Utilisation du client de test WCF
Après avoir créé un projet de service WCF et appuyé sur F5 pour démarrer le débogueur, l’hôte de service WCF commence à héberger tous les services trouvés dans votre projet. Le client de test WCF s’ouvre automatiquement et affiche une liste de points de terminaison de service définis dans le fichier de configuration. À partir de la fenêtre principale, vous pouvez tester les paramètres et appeler votre service.
Pour vous assurer que le client de test WCF est utilisé, cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, sélectionnez Propriétés, puis sélectionnez l’onglet Débogage . Cliquez sur Démarrer le projet et vérifiez que les éléments suivants s’affichent dans la boîte de dialogue Arguments de ligne de commande .
/client:WcfTestClient.exe
Utilisation d’un client personnalisé
Pour utiliser un client personnalisé, cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, sélectionnez Propriétés, puis sélectionnez l’onglet Débogage . Cliquez sur Démarrer le projet et modifiez le /client
paramètre dans la boîte de dialogue Arguments de ligne de commande pour pointer vers votre client personnalisé, comme indiqué dans l’exemple suivant.
/client:"path/CustomClient.exe"
Lorsque vous appuyez sur F5 pour redémarrer le service, l’hôte de service WCF démarre automatiquement votre client personnalisé lorsque vous lancez le débogueur.
Vous pouvez également utiliser le /clientArg:
paramètre pour spécifier une chaîne en tant qu’argument passé à l’application cliente personnalisée, comme indiqué dans l’exemple suivant.
/client:"path/CustomClient.exe" /clientArg:"arguments that are passed to Client"
Par exemple, si vous utilisez le modèle bibliothèque de services syndication, vous pouvez utiliser les arguments de ligne de commande suivants,
/client:iexplore.exe /clientArgs:http://localhost:8731/Design_Time_Addresses/Feed1/
Ne spécifier aucun client
Pour spécifier qu’aucun client n’est utilisé après l’hébergement du service WCF, cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, sélectionnez Propriétés, puis sélectionnez l’onglet Débogage . Cliquez sur Démarrer le projet et laissez la boîte de dialogue Arguments de ligne de commande vide.
Utilisation d’un hôte personnalisé
Pour utiliser un hôte personnalisé, cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, sélectionnez Propriétés, puis sélectionnez l’onglet Débogage . Cliquez sur Démarrer le programme externe et entrez le chemin complet de l’hôte personnalisé. Vous pouvez également utiliser la boîte de dialogue Arguments de ligne de commande pour spécifier les arguments à passer à l’hôte.
Interface utilisateur de l’hôte de service WCF
Lorsque vous appelez initialement l’hôte de service WCF (en appuyant sur F5 à l’intérieur de Visual Studio), la fenêtre Hôte de service WCF s’ouvre automatiquement. Lorsque l’hôte de service WCF est en cours d’exécution, l’icône du programme apparaît dans la zone de notification. Double-cliquez sur l’icône pour ouvrir la fenêtre Hôte du service WCF
Lorsque des erreurs se produisent lors de l’hébergement du service, la boîte de dialogue Hôte de service WCF s’ouvre pour afficher les informations pertinentes.
La fenêtre principale de l’hôte de service WCF contient deux menus :
Fichier : contient les commandes Close et Exit . Lorsque vous cliquez sur Fermer, la boîte de dialogue Hôte du service WCF se ferme, mais les services continuent d’être hébergés. Lorsque vous cliquez sur Quitter, l’hôte de service WCF est également arrêté. Cela arrête également tous les services hébergés.
Aide : contient la commande About qui contient des informations de version. Il contient également la commande d’aide qui peut ouvrir un fichier d’aide.
La fenêtre hôte du service WCF principale contient deux zones :
La première zone est Service. Il contient une liste qui affiche les informations de base de tous les services. Les informations incluent :
Service : répertorie tous les services.
État : répertorie l’état du service. Les valeurs valides sont « Started », « Stopped » et « Error ».
Adresse des métadonnées : affiche l’adresse des métadonnées des services.
La deuxième zone est Des informations supplémentaires. Il affiche une explication détaillée de l’état du service lorsque la ligne de service spécifique est sélectionnée dans la zone de service . Si l’état est Error, vous pouvez afficher le message d’erreur complet à l’écran.
Arrêt de l'Hôte de service WCF
Vous pouvez arrêter l’hôte de service WCF de quatre façons :
Arrêtez la session de débogage dans Visual Studio.
Sélectionnez Quitter dans le menu Fichier dans la fenêtre Hôte du service WCF .
Sélectionnez Quitter dans le menu contextuel de l’icône de la barre d’état hôte du service WCF dans la zone de notification système.
Quittez le client de test WCF s’il est utilisé.
Utilisation de l’hôte de service sans privilège Administrateur
Pour permettre aux utilisateurs sans privilège administrateur de développer des services WCF, une liste de contrôle d’accès (ACL) est créée pour l’espace de noms «http://+:8731/Design_Time_Addresses" ; pendant l’installation de Visual Studio. La liste ACL a la valeur (UI), qui inclut tous les utilisateurs interactifs ayant ouvert une session sur l'ordinateur. Les administrateurs peuvent ajouter ou supprimer des utilisateurs de cette liste de contrôle d’accès, ou ouvrir des ports supplémentaires. Cette liste de contrôle d’accès permet aux utilisateurs d’utiliser l’hôte automatique du service WCF (wcfSvcHost.exe) sans leur accorder de privilèges d’administrateur.
Vous pouvez modifier l’accès à l’aide de l’outil netsh.exe dans Windows Vista sous le compte d’administrateur avec élévation de privilèges. Voici un exemple d’utilisation de netsh.exe.
netsh http add urlacl url=http://+:8001/MyService user=<domain>\<user>
Pour plus d’informations sur netsh.exe, consultez « Comment utiliser l’outil Netsh.exe et les commutateurs Command-Line ».