Compartir a través de

Consumo de un adaptador de ADAPTADOR DE LOB de WCF en un proyecto de .NET

  • Artículo

Para consumir un adaptador creado mediante el SDK del adaptador de LOB de WCF desde Visual Studio, debe agregar una referencia de servicio al proyecto. Puede hacerlo de la siguiente forma:

  • Con el complemento Agregar referencia del servicio adaptador de Visual Studio, que se instala como parte del SDK del adaptador de LOB de WCF.

  • Con svcutil.exe (utilidad de metadatos de ServiceModel), que se instala como parte del SDK de Windows.

Agregar una referencia de servicio mediante el complemento Agregar referencia de servicio de adaptador

El complemento Agregar referencia del servicio adaptador se puede usar para examinar y buscar metadatos, y para generar clases de proxy clR de .NET mediante las operaciones y los tipos seleccionados.

  1. Abra la aplicación .NET en Visual Studio.

  2. En Visual Studio, haga clic con el botón derecho en el menú Proyecto y, a continuación, haga clic en Agregar referencia de servicio de adaptador.

    Nota

    Esta opción no aparece para los proyectos de BizTalk Server.

  3. En la pantalla Add Adapter Service Reference Plug-in (Agregar complemento de referencia de servicio de adaptador), en la lista desplegable Seleccionar un enlace de enlace , seleccione un enlace de adaptador.

  4. Para configurar el URI de conexión para el enlace de adaptador seleccionado y para proporcionar credenciales, propiedades de URI y propiedades de enlace, haga clic en Configurar. Los requisitos reales varían en función del enlace de adaptador seleccionado.

  5. Cuando haya configurado el URI, haga clic en Aceptar.

  6. Haga clic en Conectar. Si el URI de conexión es válido y se aceptan credenciales de cliente (si existen), el panel Categoría debe rellenarse con las categorías y las operaciones proporcionadas por el adaptador.

  7. Si el adaptador admite la búsqueda, el campo de búsqueda estará activo. De lo contrario, puede filtrar por tipo de contrato, explorar tipos y operaciones haciendo clic en nodos en el panel Categoría .

  8. Para las opciones avanzadas de generación de proxy, haga clic en Avanzadas. Existen varias opciones:

    Opción Opción de svcutil.exe equivalente Descripción
    Generación de métodos asincrónicos /async Genera firmas del método sincrónicas y asincrónicas.

    Valor predeterminado (si no está seleccionado): solo genera firmas de método sincrónico.
    Generación de contratos de mensajes /messageContract Genera tipos de contrato de mensaje.
    Hacer que los tipos sean internos /internal Genera clases que están marcadas como internas.

    Valor predeterminado (si no está seleccionado): genere clases públicas.
    Habilitación del enlace de datos /enableDataBinding Implementa la interfaz System.ComponentModel.INotifyPropertyChanged en todos los tipos de contrato de datos para habilitar el enlace de datos.
    Importar tipos que no son de datos como IXmlSerializable /importXmlTypes Configura el serializador de contratos de datos para importar tipos que no son de contratos de datos como tipos IXmlSerializable.
    Generar interfaz de canal Genera la interfaz de canal.
    Marcar clases serializables Selecciona si se van a generar los tipos de datos con un serializador.
    No generar app.config /noConfig No genera el archivo de configuración de la aplicación.
    serializer

    Automático    		 /serializer:Auto Selecciona automáticamente el serializador para la serialización y deseralización.
    serializer

    Serializador dataContract    		 /serializer:DataContractSerializer Genera tipos de datos que usan el serializador de contrato de datos para la serialización y des serialización
    serializer

    Xmlserializer    		 /serializer:XmlSerializer Genera tipos de datos que usan XmlSerializer para la serialización y deserialización.

  9. Para generar los artefactos de proxy, haga clic en Aceptar. El número de artefactos varía en función del tipo de contrato.

    Tipo de contrato Artefacto Descripción
    Salida CLR WCF Proxy Contiene el contrato y la implementación del servicio.
    Salida App.config Contiene los <elementos de punto de conexión> y <enlaces> para <el sistema. Cliente> ServiceModel><.
    Entrada Interfaz de servicio WCF de CLR Contiene el contrato.
    Entrada Implementación del servicio WCF de CLR Implementación de código auxiliar que deriva del contrato.
    Entrada App.config Contiene los <elementos endpoint>, <bindings> y <behaviors> para <el sistema. Servicio> ServiceModel><.

  10. Ahora puede usar el proxy en la aplicación.

Adición de una referencia de servicio mediante svcutil.exe

Svcutil.exe es una utilidad de línea de comandos que se puede usar para recuperar metadatos y generar clases de proxy clR de .NET, que luego se pueden agregar a un proyecto de Visual Studio. Para obtener más información sobre svcutil.exe, vea ServiceModel Metadata Utility Tool (Svcutil.exe)).

Para generar una clase de proxy desde un adaptador hospedado en IIS

  1. En el símbolo del sistema, escriba svcutil.exe "<http://localhost/adapter/AdapterService.svc?wsdl"> /config:app.config. Reemplace la ruta de acceso HTTP por la ruta de acceso correcta para el adaptador hospedado. Esto crea un archivo .cs que contiene el proxy CLR de .NET y output.config que contiene los enlaces y el <punto de conexión> de cliente <para <system.serviceModel>.>

    Nota

    Si el adaptador contiene muchas operaciones, puede limitar las operaciones devueltas mediante una cadena de consulta de "op=" seguida del nombre de la operación en la que está interesado. Por ejemplo: svcutil.exe “http://localhost/adapter/AdapterService.svc?wsdl&op=Echo/EchoString&op=Echo/EchoArray” genera código de proxy solo para las operaciones EchoString y EchoArray.

  2. Abra el proyecto en Visual Studio.

    1. En Explorador de soluciones, haga clic con el botón derecho en el proyecto, seleccione Agregar y, a continuación, haga clic en Nuevo elemento. En el cuadro de diálogo Agregar elemento existente , seleccione los archivos .cs y app.config creados anteriormente. Haga clic en Agregar.

    2. En el Explorador de soluciones, haga clic con el botón secundario del mouse en Referencias y, a continuación, haga clic en Agregar referencia. En la pestaña .NET , seleccione System.ServiceModel y, a continuación, haga clic en Aceptar. Ahora puede usar el proxy en la aplicación.

Consulte también

Tutorial 1: Desarrollar el adaptador de Echo
Consumo de un adaptador creado mediante el SDK del adaptador de LOB de WCF