Cómo llamar a operaciones del servicio WCF de forma asincrónica
En este tema se explica cómo puede tener acceso un cliente a una operación de servicio de forma asincrónica. El servicio en este tema implementa la interfaz ICalculator. El cliente puede llamar a las operaciones de esta interfaz de forma asincrónica mediante el modelo de llamada asincrónica orientado a eventos. (Para obtener más información acerca del modelo de llamada asincrónica orientado a eventos, vea Multithreaded Programming with the Event-based Asynchronous Pattern). Para obtener un ejemplo que muestra cómo implementar de forma asincrónica una operación en un servicio, vea Cómo: Implementar una operación de servicios asincrónica. Para obtener más información acerca de las operaciones sincrónicas y asincrónicas, vea Operaciones sincrónicas y asincrónicas.
Nota
El modelo de llamada asincrónica orientado a eventos no es compatible con la utilización de un ChannelFactory. Para obtener más información acerca de la realización de llamadas asincrónicas mediante el ChannelFactory, vea Cómo llamar a operaciones de manera asincrónica mediante un generador de canales.
Procedimiento
Para llamar a operaciones de servicio WCF de forma asincrónica
Ejecute la herramienta ServiceModel Metadata Utility Tool (Svcutil.exe) con las opciones de comando /async y /tcv:Version35 a la vez, como muestra el comando siguiente.
svcutil /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples https://localhost:8000/servicemodelsamples/service/mex /a /tcv:Version35De este modo se genera, además de las operaciones sincrónicas y las operaciones estándar asincrónicas basadas en delegado, una clase de cliente WCF que incluye:
- Dos operaciones <operationName>Async que se utilizan con el enfoque de llamada asincrónica basada en eventos. Por ejemplo:
- Eventos completados de operación del formulario <operationName>Completed que se utilizan con el enfoque de llamada asincrónica basada en eventos. Por ejemplo:
- Tipos System.EventArgs para cada operación (del formulario <operationName>CompletedEventArgs) que se utilizan en el enfoque de llamada asincrónica basado en eventos. Por ejemplo:
En la aplicación de llamada, cree un método de devolución de llamada al que llamar cuando la operación asincrónica finalice, tal y como se muestra en el siguiente código de ejemplo.
Antes de llamar a la operación, utilice un nuevo genérico System.EventHandler de tipo <operationName>EventArgs para agregar el método del controlador (creado en el paso anterior ) al evento <operationName>Completed. A continuación, llame al método <operationName>Async. Por ejemplo:
Ejemplo
Nota
Las directrices de diseño del modelo asincrónico basado en eventos afirman que si se devuelve más de un valor, uno de los valores se devuelve como propiedad Result y los demás se devuelven como propiedades del objeto EventArgs. Una de las consecuencias de esto, es que el cliente importa metadatos utilizando las opciones de comando asincrónicas basadas en eventos y la operación devuelve más de una valor, el objeto predeterminado EventArgs devuelve un valor como propiedad Result, y el resto son propiedades del objeto EventArgs.Para recibir el objeto de mensaje como propiedad Result y que los valores devueltos sean propiedades de ese objeto, se utiliza la opción de comando /messageContract. Esto genera una firma que devuelve el mensaje de respuesta como la propiedad Result del objeto EventArgs. Todos los valores de devolución internos se convierten, pues, en propiedades del objeto de mensaje de respuesta.