Channel Factory

Cet exemple montre comment une application cliente peut créer un canal avec la classe ChannelFactory au lieu d'un client généré. Cet exemple est basé sur Getting Started, exemple qui implémente un service de calculatrice.

Remarque :
La procédure d'installation ainsi que les instructions de génération relatives à cet exemple figurent en fin de rubrique.

Cet exemple utilise la classe ChannelFactory pour créer un canal à un point de terminaison de service. En général, pour créer un canal à un point de terminaison de service, vous générez un type de client avec l'Service Model Metadata Utility Tool (Svcutil.exe) et créez une instance du type généré. Vous pouvez également créer un canal en utilisant la classe ChannelFactory, comme le montre cet exemple. Le service créé par l'exemple de code suivant est identique au service de la section Getting Started, exemple.

EndpointAddress address = new EndpointAddress("https://localhost/servicemodelsamples/service.svc");
WSHttpBinding binding = new WSHttpBinding();
ChannelFactory<ICalculator> factory = new 
                    ChannelFactory<ICalculator>(binding, address);
ICalculator channel = factory.CreateChannel();

Remarque :
Si vous exécutez cet exemple dans un scénario à plusieurs ordinateurs, vous devez remplacer « localhost » dans le code précédent par le nom qualifié complet de l'ordinateur qui exécute le service. Cet exemple n'utilise pas de configuration pour définir l'adresse de point de terminaison, donc cela doit être fait dans le code.

Une fois le canal créé, les opérations de service peuvent être appelées comme pour un client généré.

// Call the Add service operation.
double value1 = 100.00D;
double value2 = 15.99D;
double result = channel.Add(value1, value2);
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

Pour fermer le canal, il faut d'abord le caster en une interface IClientChannel. Cela est dû au fait que le canal, tel que généré, est déclaré dans l'application cliente à l'aide de l'interface ICalculator, qui possède des méthodes comme Add et Subtract mais pas Close. La méthode Close provient de l'interface ICommunicationObject.

// Close the channel.
 ((IClientChannel)client).Close();

Lorsque vous exécutez l'exemple, les demandes et réponses d'opération s'affichent dans la fenêtre de console cliente. Appuyez sur ENTER dans la fenêtre de l'application pour fermer l'application cliente.

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.

Pour configurer, générer et exécuter l'exemple

1. Assurez-vous d'avoir effectué la procédure indiquée à la section Procédure d'installation unique pour les exemples Windows Communication Foundation.

2. Pour générer l'édition C# ou Visual Basic .NET de la solution, suivez les instructions indiquées dans Génération des exemples Windows Communication Foundation. Notez que cet exemple n'active pas la publication des métadonnées. Vous devez d'abord activer la publication des métadonnées pour cet exemple pour régénérer le type de client.

3. Pour exécuter l'exemple dans une configuration à un ou plusieurs ordinateurs, suivez les instructions indiquées dans Exécution des exemples Windows Communication Foundation.

Pour exécuter l'exemple sur plusieurs ordinateurs

1. Remplacez « localhost » dans le code suivant par le nom qualifié complet de l'ordinateur qui exécute le service.

   EndpointAddress address = new EndpointAddress("https://localhost/servicemodelsamples/service.svc");
   

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