Partager via


Comment : utiliser un client Windows Communication Foundation

Il s'agit de la sixième des six tâches requises pour créer un service Windows Communication Foundation (WCF) de base et un client pouvant appeler le service. Pour une vue d'ensemble des six tâches, consultez la rubrique Didacticiel de mise en route.

Une fois qu'un proxy Windows Communication Foundation (WCF) a été créé et configuré, une instance client peut être créée, et l'application cliente peut être compilée et utilisée pour communiquer avec le service WCF. Cette rubrique décrit les procédures pour la création et l'utilisation d'un client WCF. Cette procédure accomplit trois tâches : elle crée un client WCF, appelle les opérations de service à partir du proxy généré et ferme le client une fois que l'appel d'opération est terminé.

Le code évoqué dans la procédure est aussi fourni dans l'exemple qui suit la procédure. Le code dans cette tâche doit être placé dans la méthode Main() de la classe Program générée dans le projet client.

Pour utiliser un client Windows Communication Foundation

  1. Créez une instance EndpointAddress pour l'adresse de base du service que vous allez appeler, puis créez un objet WCFClient.

  2. Appelez les opérations clientes à partir du Client.

  3. Appelez Close sur le client WCF et attendez que l'utilisateur appuie sur la touche Entrée pour mettre fin à l'application.

Exemple

L'exemple suivant vous montre comment créer un client WCF, comment appeler les opérations du client, et comment fermer le client au terme de l'appel d'opération.

Compilez le client WCF généré et l'exemple de code suivant dans un fichier exécutable nommé Client.exe. Veillez à référencer System.ServiceModel lors de la compilation du code.

Vérifiez que le service s'exécute avant d'essayer d'utiliser le client. Pour plus d'informations, consultez Comment : héberger et exécuter un service Windows Communication Foundation de base.

Pour lancer le client, démarrez une session console Kit de développement logiciel Windows en sélectionnant Environnement de commande sous l'entrée Kit de développement Microsoft Windows dans le menu Démarrer. Accédez au répertoire C:\Users\<nom_utilisateur>\Documents\Visual Studio 2005\Projects\Service\Client\bin\Debug, puis tapez client et appuyez sur la touche Entrée. Les demandes et réponses de l'opération sont affichées dans la fenêtre de console cliente comme suit.

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714
Press <ENTER> to terminate client.

Si vous voyez cette sortie, cela signifie que vous avez complété le didacticiel avec succès. Cet exemple illustre comment configurer le client WCF dans le code. Pour obtenir des informations de dépannage, consultez Dépannage du didacticiel de mise en route.

Voir aussi

Tâches

Comment : créer un client Windows Communication Foundation
Comment : créer un contrat duplex
Comment : accéder aux services ayant un contrat duplex

Autres ressources

Génération de clients
Didacticiel de mise en route
Programmation WCF de base
Getting Started Sample
Self-Host