Compartir a través de


Plantillas de Visual Studio para WCF

Las plantillas de Visual Studio para Windows Communication Foundation (WCF) son plantillas de proyecto y elemento predefinidas que puede usar en Visual Studio para compilar rápidamente servicios WCF y aplicaciones circundantes.

Utilización de las plantillas de WCF

Las plantillas para WCF de Visual Studio 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 de WCF está disponible en el cuadro de diálogo de nuevo proyecto en Visual C#\WCF y Visual Basic\WCF.

Al crear un nuevo proyecto mediante la plantilla 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. Este 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 punto de conexión 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 el Host de servicios 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 Aplicación del servicio de WCF

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

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

  • Archivo de host del 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. Esto crea los mismos archivos que la plantilla Aplicación del servicio de WCF pero los organiza como si fuera un sitio web ASP.NET. Se crean las carpetas App_Code y App_Data.

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 de Visual Studio existentes.

Para utilizar esta plantilla, vaya al panel Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto, sitúe el puntero en Agregar y, luego, 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 fusionar mediante combinación 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 acceder 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 más información sobre estos tipos de flujo de trabajo, consulte Creación de un flujo de trabajo. Para más información sobre cómo crear proyectos de flujo de trabajo, consulte Creación de proyectos de flujo de trabajo heredados.

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

Plantilla Biblioteca de servicio de distribución de WCF

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

Cambiar la dirección o la fuente

La plantilla de redifusión usa un explorador web durante la ejecución. Cuando haga clic con el botón derecho en su proyecto en el Explorador de soluciones en Visual Studio, seleccione Propiedades y, luego, elija la pestaña Depurar; podrá ver la dirección predeterminada de la plantilla. El explorador intenta abrir la fuente en esta dirección.

Si cambia la dirección de la fuente, también debe cambiar la dirección en la pestaña Depurar. Si no lo hace, el explorador intenta abrir la fuente en la dirección predeterminada y produce un error.

Plantilla de elementos de servicio WCF con AJAX habilitado

Esta plantilla expone un control AJAX como un servicio WCF. Para más información sobre los controles AJAX, consulte la documentación de los controles 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 la comunicación 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 acceder a esta plantilla, haga clic con el botón derecho en un proyecto de sitio o 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.

Nota

El servicio WCF habilitado para Silverlight expone un punto de conexión 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 punto de conexión correctamente, debería usar la autenticación de ASP.NET, HTTPS u otros mecanismos.

Consulte también