Plantillas de Visual Studio para WCF

Artículo
10/07/2008

Las plantillas para Visual Studio de Windows Communication Foundation (WCF) son plantillas de proyecto y de elemento predefinidas que pueden utilizarse en Visual Studio para generar rápidamente servicios WCF y las aplicaciones relacionadas.

Utilización de las plantillas de WCF

Las plantillas para Visual Studio de WCF proporcionan una estructura de clases básica para el desarrollo de servicios. En concreto, estas plantillas proporcionan las definiciones básicas para el contrato de servicios y el contrato de datos, así como la implementación y configuración del servicio. Puede utilizar estas plantillas para crear un servicio simple con una interacción de código mínima, además de una unidad de creación para servicios más avanzados.

Plantilla de proyecto de biblioteca de servicio WCF

La plantilla de proyecto de biblioteca de servicio WCF está disponible en el cuadro de diálogo del nuevo proyecto en Visual C#\WCF y Visual Basic\WCF.

Al crear un nuevo proyecto mediante la plantilla de Servicio WCF, el nuevo proyecto incluye automáticamente los tres archivos siguientes:

Archivo de contrato de servicio (IService1.cs o IService1.vb). El archivo de contrato de servicio es una interfaz a la que se aplican los atributos de servicio WCF. Este archivo proporciona una definición de un servicio simple que muestra cómo definir los servicios, e incluye operaciones basadas en parámetros y un ejemplo de contrato de datos simple. Éste es el archivo predeterminado mostrado en el editor de código después de crear un proyecto de servicio WCF.
Archivo de implementación de servicio (Service1.cs o Service1.vb). El archivo de implementación de servicio implementa el contrato definido en el archivo de contrato de servicio.
Archivo de configuración de la aplicación (App.config). El archivo de configuración proporciona los elementos básicos de un modelo de servicio WCF con un enlace HTTP seguro. Además incluye un extremo para el servicio y habilita el intercambio de metadatos.

Nota Visual Studio está configurado para reconocer el archivo App.config como archivo de configuración para el proyecto cuando se ejecuta mediante Host de servicio WCF (WcfSvcHost.exe), que es la configuración predeterminada. Si hospeda la biblioteca de servicios en un ejecutable, sitúe el código de configuración en el archivo de configuración del ejecutable, ya que los archivos de configuración para DLL no son válidos.

Plantilla de servicio de aplicación web de WCF

La plantilla de servicio de aplicación web de WCF está disponible en el cuadro de diálogo Nuevo proyecto en Visual C#\Web y Visual Basic\Web.

Al crear un proyecto nuevo con la plantilla del servicio de aplicación web de WCF, el proyecto incluye los cuatro archivos siguientes:

Archivo de host de servicio (service1.svc)
Archivo de contrato de servicio (IService1.cs o IService1.vb)
Archivo de implementación de servicio (Service1.cs o Service1.vb)
Archivo de configuración web (web.config)

La plantilla crea automáticamente un sitio web (que se implementará en un directorio virtual), y hospeda un servicio en él.

Plantilla de sitio web de WCF

La plantilla de sitio web de WCF está disponible en el cuadro de diálogo Nuevo proyecto, en Visual C#\Sitio web\Servicio WCF y Visual Basic\Sitio web\Servicio WCF.

Plantilla de elementos de servicio WCF

La plantilla de elementos de servicio WCF es una plantilla personalizada que proporciona una manera rápida de agregar servicios WCF a los proyectos Visual Studio existentes.

Para utilizar esta plantilla, vaya al panel Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto, sitúe el puntero en Agregary, a continuación, haga clic en Nuevo elemento para abrir el cuadro de diálogo Agregar nuevo elemento.

La interfaz de servicio y los archivos de implementación están situados en la carpeta raíz del proyecto.

La plantilla intenta combinar la sección de configuración del nuevo servicio con el archivo de configuración existente, si sus tipos son compatibles.

Si el proyecto existente es un proyecto web, también se crea un archivo de host de servicio (service1.svc).

Plantilla de proyectos y elementos WF del servicio WCF.

Estas plantillas crean servicios WCF que hospedan un servicio de flujo de trabajo, que es un flujo de trabajo al que se puede obtener acceso como a un servicio web. Existen plantillas independientes para XAML o modelos de programación imperativos. Con las plantillas, puede crear un flujo de trabajo de equipo secuencial o de estado. Para obtener más información sobre estos tipos de flujo de trabajo, vea Windows Workflow Foundation Tutorials. Para obtener más información sobre la creación de proyectos de flujo de trabajo, vea Creating Workflow Projects.

El diseñador Visual Studio es más sensible si se utilizan flujos de trabajo de tipo XOML en lugar de los flujos basados en código. El flujo de trabajo de XOML es el tipo de flujo predeterminado que se crea.

Plantilla de sindicación de WCF

Esta plantilla permite exponer la fuente con el formato RSS o ATOM como un servicio WCF. Para obtener más información, vea WCF Syndication.

Cambiar la dirección o la fuente

La plantilla de distribución utiliza Internet Explorer durante la ejecución. Cuando hace clic con el botón secundario en su proyecto en Explorador de soluciones, en Visual Studio, seleccione Propiedades y, a continuación, seleccione la ficha Depurar. Internet Explorer intentará abrir la fuente en esta dirección.

Si cambia la dirección de su fuente, también debe cambiar la dirección de la ficha de Depuración. Si no lo hace, Internet Explorer intentará abrir la fuente en la dirección predeterminada y no lo conseguirá.

Plantilla de elementos de servicio WCF habilitado para AJAX

Esta plantilla expone un control AJAX como un servicio WCF. Para obtener más información sobre los controles AJAX, vea la documentación del control AJAX.

Plantilla de elementos de servicio WCF habilitado para Silverlight

Esta plantilla crea un servicio web que proporciona datos a un cliente o front-end de Silverlight. La plantilla se puede agregar a un sitio web o proyecto de aplicación web para crear un servicio WCF, que incluye la configuración y el código del servicio que permiten comunicar con un cliente de Silverlight. Después, puede usar Agregar referencia de servicio para agregar un proxy de cliente del servicio al cliente e intercambiar datos entre el cliente de Silverlight y el servicio WCF habilitado para Silverlight.

Para tener acceso a esta plantilla, haga clic con el botón secundario en un sitio web o proyecto de aplicación web en el Explorador de soluciones, haga clic en Agregar nuevo elemento y haga clic en la opción correspondiente al servicio WCF habilitado para Silverlight.

Precaución El servicio WCF habilitado para Silverlight expone un extremo basicHttpBinding sin habilitar ninguna configuración de seguridad. Por lo tanto, todos los clientes que se conectan a este servicio pueden obtener información sobre el mismo. Los mensajes que se intercambian entre el servicio y el cliente tampoco están firmados ni cifrados. Para proteger el extremo correctamente, debería usar la autenticación de ASP.NET, HTTPS u otros mecanismos.

Consulte también

Conceptos

Host de servicio WCF (WcfSvcHost.exe)
Cliente de prueba de WCF (WcfTestClient.exe)