Cómo usar un cliente de Windows Communication Foundation

Ésta es la sexta de las seis tareas que son necesarias para crear un servicio de Windows Communication Foundation (WCF) básico y un cliente que puede llamar al servicio. Para obtener información general de las seis tareas, consulte el tema Tutorial de introducción.

Una vez creado y configurado un proxy de Windows Communication Foundation (WCF), se puede crear una instancia de cliente y la aplicación de cliente se puede compilar y utilizar para comunicar con el servicio WCF. En este tema se describen los procedimientos para crear y utilizar un cliente de WCF. Este procedimiento hace tres cosas: crea un cliente de WCF, llama a las operaciones de servicio desde el proxy generado y cierra el cliente una vez que se completa la llamada de la operación.

El código discutido en el procedimiento también se proporciona en el ejemplo que sigue al procedimiento. El código de esta tarea se debería colocar en el método Main() de la clase Program generada en el proyecto de cliente.

Uso de un cliente de Windows Communication Foundation

1. Cree una instancia EndpointAddress para la dirección base del servicio que va llamar y, a continuación, cree un objeto Client de WCF.

2. Llame a las operaciones del cliente desde dentro del Client.

3. Llame a Close en el cliente WCF y espere hasta que el usuario presione la tecla Entrar para terminar la aplicación.

Ejemplo

El siguiente ejemplo muestra cómo crear un cliente de WCF, cómo llamar a las operaciones del cliente y cómo cerrar el cliente una vez que se completa la llamada de la operación.

Compile el cliente de WCF generado y el siguiente código de ejemplo en un una aplicación ejecutable de nombre Client.exe. Asegúrese de hacer referencia a System.ServiceModel al compilar el código.

Asegúrese de que el servicio se está ejecutando antes de intentar utilizar el cliente. Para obtener más información, consulte Procedimiento para hospedar y ejecutar un servicio básico de Windows Communication Foundation.

Para ejecutar el cliente, inicie una sesión de consola SDK de Windows seleccionando CMD Shell bajo la entrada Microsoft Windows SDK en el menú Inicio. Navegue hasta el directorio C:\Users\<nombre de usuario>\Documents\Visual Studio 2005\Projects\Service\Client\bin\Debug, escriba cliente y presione ENTRAR. Las solicitudes y respuestas de la operación se muestran en la ventana de la consola del cliente de la siguiente manera.

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 obtiene este resultado, ha completado el tutorial correctamente. Este ejemplo muestra cómo configurar el cliente de WCF mediante código. Para obtener más información, consulte Solución de problemas con el tutorial de introducción.

Consulte también

Tareas

Creación de un cliente de Windows Communication Foundation
Creación de un contrato dúplex
Cómo: Obtener acceso a los servicios con un contrato dúplex

Otros recursos

Generación de clientes
Tutorial de introducción
Programación básica de WCF
Getting Started Sample
Self-Host