Generar un cliente de WCF o un contrato de servicio WCF para artefactos de SQL Server
Puede usar el complemento Agregar referencia del servicio adaptador de Visual Studio para generar una clase de cliente WCF destinada a las operaciones seleccionadas en SQL Server artefactos. También puede usar la Herramienta de utilidad de metadatos serviceModel (svcutil.exe) para generar la clase de cliente WCF; Sin embargo, el complemento Agregar referencia del servicio adaptador expone la funcionalidad de la herramienta de utilidad de metadatos serviceModel a través de una interfaz estándar de Microsoft Windows. También proporciona funcionalidades de búsqueda y exploración que no están disponibles con la herramienta de svcutil.exe y genera un archivo de configuración basado en las propiedades de enlace que seleccione al conectarse a la base de datos de SQL Server.
Generación de una clase de cliente WCF mediante el complemento agregar referencia del servicio adaptador
Realice los pasos siguientes para generar una clase de cliente WCF mediante el complemento Agregar referencia del servicio adaptador.
En Visual Studio Explorador de soluciones, haga clic con el botón derecho en el proyecto y, a continuación, haga clic en Agregar referencia de servicio de adaptador.
Una vez que se abra el cuadro de diálogo Agregar referencia de servicio de adaptador, siga los pasos descritos en Obtención de metadatos para SQL Server operaciones en Visual Studio mediante el adaptador de SQL para conectarse a SQL Server y para buscar operaciones. Para crear una clase de cliente WCF para las operaciones que seleccione, asegúrese de que el cliente (operaciones salientes) esté seleccionado en la lista desplegable Seleccionar tipo de contrato . (Este es el valor predeterminado).
Después de seleccionar todas las operaciones de destino, haga clic en Aceptar para generar la clase de cliente WCF.
El complemento Agregar referencia de servicio de adaptador agrega dos archivos al proyecto:
El archivo de código del cliente WCF. Este archivo contiene la clase de cliente WCF generada y el código auxiliar para las operaciones que seleccionó. La primera vez que ejecute el complemento Agregar referencia del servicio adaptador de Visual Studio, generará este archivo con el nombre predeterminado SQLAdapterBindingClient.cs. Si vuelve a ejecutarlo, el siguiente archivo que genera se llamará SQLAdapterBindingClient1.cs. El sufijo numérico aumentará en 1 para cada archivo nuevo que genere. También puede cambiar el prefijo predeterminado SQLBinding escribiendo otro prefijo en el campo Prefijo de nombre de archivo del complemento Agregar referencia del servicio adaptador de Visual Studio antes de seleccionar Aceptar para generar el archivo.
App.config. Este archivo contiene una configuración de enlace y configuraciones de punto de conexión de cliente que se basan en las selecciones realizadas al configurar la conexión para el complemento Agregar referencia del servicio adaptador.
Importante
Al usar el complemento Agregar referencia del servicio adaptador, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo app.config. Debe agregar manualmente la propiedad de enlace y su valor en el archivo app.config, si es necesario.
Generación de un contrato de servicio WCF mediante el complemento Agregar referencia del servicio adaptador
En el caso de las operaciones entrantes, como sondear la base de datos SQL Server o recibir notificaciones de la base de datos, el adaptador de SQL ejecuta una consulta especificada por la aplicación cliente (en caso de sondeo) o registra una consulta con SQL Server (en caso de notificación). En ambos escenarios, el adaptador envía el mensaje entrante de SQL Server base de datos al consumo. En tal caso, la aplicación que consume actúa como un servicio y el adaptador de SQL actúa como cliente. Por lo tanto, debe implementar un servicio WCF que pueda recibir operaciones entrantes del adaptador. Para ello, use el complemento Agregar referencia del servicio adaptador para generar una interfaz de .NET que represente el contrato de servicio que expone el adaptador para las operaciones entrantes. Esta interfaz de .NET también se denomina contrato de servicio WCF. A continuación, implementará esta interfaz para crear el servicio WCF que puede usar para recibir las operaciones entrantes.
Realice los pasos siguientes para generar un contrato de servicio WCF mediante el complemento Agregar referencia del servicio adaptador.
Para generar un contrato de servicio WCF para las operaciones entrantes
En Visual Studio Explorador de soluciones, haga clic con el botón derecho en el proyecto y, a continuación, haga clic en Agregar referencia de servicio de adaptador.
Una vez que se abra el cuadro de diálogo Agregar referencia de servicio de adaptador, siga los pasos descritos en Conexión a SQL Server en Visual Studio Mediante el complemento agregar referencia del servicio adaptador para conectarse a la base de datos de SQL Server.
Importante
Si va a generar el contrato de servicio WCF para la operación de entrada TypedPolling , debe especificar InboundID como parte de la propiedad de enlace URI de conexión y PollingStatement .
Después de conectarse a la base de datos de SQL Server, seleccione Servicio (operaciones de entrada) en la lista desplegable Seleccionar tipo de contrato.
En el cuadro Seleccionar una categoría , haga clic en el nodo raíz (/), seleccione la operación de entrada en el cuadro Categorías y operaciones disponibles y, a continuación, haga clic en Agregar.
Para generar el contrato de servicio WCF para la operación de entrada, haga clic en Aceptar.
El complemento Agregar referencia del servicio adaptador agrega tres archivos al proyecto:
SqlAdapterBindingInterface.cs. Este archivo contiene el contrato de servicio WCF generado (interfaz) y el código auxiliar para la operación entrante.
SqlAdapterBindingService.cs. Este archivo contiene una clase que implementa la interfaz definida en SqlAdapterBindingInterface.cs. Puede implementar la lógica de negocios que procesa los registros devueltos por la operación entrante.
app.config. Este archivo contiene una configuración de enlace, comportamientos de punto de conexión y configuración de punto de conexión de servicio que se basan en las selecciones realizadas al configurar el enlace y la conexión para el complemento Agregar referencia del servicio adaptador.
Importante
Al usar el complemento Agregar referencia del servicio adaptador, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo app.config. Debe agregar manualmente la propiedad de enlace y su valor en el archivo app.config, si es necesario.
Generación de una clase de cliente WCF mediante svcutil.exe
Puede usar svcutil.exe para generar una clase de cliente WCF para la aplicación. Debe configurar svcutil.exe para usarlo con el adaptador de SQL.
Svcutil.exe genera la clase de cliente WCF en un archivo de salida con un nombre de archivo predeterminado de output.cs. Debe incluir manualmente este archivo en el proyecto de Visual Studio. Para obtener más información sobre svcutil.exe, vea ServiceModel Metadata Utility Tool (Svcutil.exe)).
Consulte también
Desarrollo de aplicaciones SQL mediante el modelo de servicio WCF