Generación de un cliente WCF o un contrato de servicio WCF para artefactos de solución de Oracle Database
Puede usar el complemento Agregar referencia de servicio de adaptador de Visual Studio para generar una clase de cliente WCF o un contrato de servicio WCF (interfaz) destinado a las operaciones seleccionadas en artefactos de base de datos de Oracle. También puede usar la Herramienta de utilidad de metadatos serviceModel (svcutil.exe) para generar la clase de cliente WCF o el contrato de servicio 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 Oracle.
Generación de una clase de cliente 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.
Para generar una clase de cliente WCF
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 del servicio adaptador , siga los pasos descritos en Recuperación de metadatos para las operaciones de Oracle en Visual Studio para conectarse a la base de datos de Oracle y examinar y 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:
OracleDBBindingClient.cs. Este archivo contiene la clase de cliente WCF generada y el código auxiliar para las operaciones que seleccionó.
App.config. Este archivo contiene una configuración de enlace y configuraciones de punto de conexión de cliente. Estas configuraciones 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 de Visual Studio, 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
El adaptador expone operaciones entrantes para permitir que la base de datos de Oracle envíe mensajes a un cliente de adaptador. Para estas operaciones, debe generar un contrato de servicio WCF. Por ejemplo, el adaptador expone una operación POLLINGSTMT entrante para sondear la base de datos de Oracle. El adaptador de base de datos de Oracle ejecuta la consulta especificada por la propiedad de enlace PollingStatement y envía el conjunto de resultados a la aplicación que consume en un mensaje POLLINGSTMT. En este escenario, la aplicación que consume actúa como servicio y el adaptador de Oracle Database actúa como cliente. Por lo tanto, debe implementar un servicio WCF que pueda recibir la operación POLLINGSTMT 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 la operación POLLINGSTMT. Esta interfaz de .NET también se denomina contrato de servicio WCF. A continuación, implemente esta interfaz para crear el servicio WCF que puede usar para recibir la operación POLLINGSTMT.
En esta sección se proporciona información sobre cómo generar un contrato de servicio WCF mediante el complemento Agregar referencia del servicio adaptador para las operaciones entrantes expuestas por el 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 Recuperación de metadatos para las operaciones de Oracle en Visual Studio para conectarse a la base de datos de Oracle. Hay varias propiedades de enlace y una propiedad URI que puede establecer al conectarse a la base de datos de Oracle para las operaciones entrantes. Por ejemplo, para la operación de sondeo de entrada (POLLINGSTMT), debe especificar la propiedad de enlace PollingStatement al configurar la conexión a la base de datos de Oracle. El adaptador de base de datos de Oracle usa la instrucción SELECT de SQL especificada en esta propiedad para generar la clase que representa el conjunto de resultados devuelto por la operación POLLINGSTMT.
Después de conectarse a la base de datos de Oracle, seleccione Servicio (operaciones entrantes) en la lista desplegable Seleccionar tipo de contrato .
En el cuadro Seleccionar una categoría , haga clic en el nodo raíz (/) y busque la operación para la que desea generar el contrato de servicio. Por ejemplo, para la operación de sondeo, seleccione POLLINGSTMT 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 POLLINGSTMT, haga clic en Aceptar.
El complemento Agregar referencia del servicio adaptador agrega tres archivos al proyecto:
OracleDBBindingInterface.cs. Este archivo contiene el contrato de servicio WCF generado (interfaz) y el código auxiliar para la operación POLLINGSTMT.
OracleDBBindingService.cs. Este archivo contiene una clase que implementa la interfaz definida en OracleDBBindingInterface.cs. Puede implementar la lógica de negocios que procesa los registros devueltos por la consulta de sondeo en el método POLLINGSTMT de esta clase.
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 de Visual Studio, 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.
Usar svcutil.exe para generar una clase de cliente WCF o un contrato de servicio WCF
Puede usar svcutil.exe para generar una clase de cliente WCF o una interfaz de servicio WCF para la aplicación. Debe configurar svcutil.exe para usarlo con el adaptador de Oracle Database. Para obtener más información sobre cómo configurar y usar svcutil.exe con el adaptador de base de datos de Oracle, vea Uso de la herramienta de utilidad de metadatos serviceModel con el adaptador de BizTalk para base de datos de Oracle.
Svcutil.exe genera la clase de cliente WCF o el contrato de servicio WCF en un archivo de salida. El nombre de archivo predeterminado es output.cs. Debe incluir manualmente este archivo en el proyecto de Visual Studio.
Consulte también
Desarrollo de aplicaciones de base de datos de Oracle mediante el modelo de servicio WCF
Realización de operaciones básicas de inserción, actualización, eliminación y selección en SQL mediante el modelo de servicio WCF