Tutorial: Creación de un servicio WCF en Windows Forms de .NET Framework

En este tutorial se muestra cómo crear un servicio de Windows Communication Foundation (WCF), probarlo y, a continuación, acceder a él desde una aplicación de Windows Forms de .NET Framework.

Nota:

Las instrucciones de este artículo muestran la versión más reciente de la experiencia de desarrollo interactiva (IDE) disponible en Visual Studio. El equipo puede mostrar nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario. Es posible que esté usando una versión diferente de Visual Studio o una configuración de entorno diferente. Para obtener más información, consulte Personalizar el IDE.

Prerrequisitos

Visual Studio con el componente windows Communication Foundation instalado. Para instalarlo:

1. Abra la aplicación Instalador de Visual Studio o seleccione Herramientas>Obtener herramientas y características en el menú de Visual Studio.
2. En el Instalador de Visual Studio, elija Modificar junto a la versión de Visual Studio que desea modificar.
3. Seleccione la pestaña Componentes individuales y, a continuación, elija Windows Communication Foundation en Actividades de desarrollo.
4. Seleccione Modificar.

Para obtener más información, consulte Modificación de cargas de trabajo, componentes y paquetes de idioma de Visual Studio.

Creación de un servicio WCF

Para crear un servicio WCF en Visual Studio, siga estos pasos:

1. En Visual Studio, seleccione Archivo>nuevo>proyecto en el menú.

2. En la página Crear un nuevo proyecto , escriba la biblioteca de servicios wcf en el cuadro de búsqueda. Seleccione la plantilla de C# o Visual Basic para la biblioteca de servicios WCF y, a continuación, seleccione Siguiente.

   

   Sugerencia

   Si no ve ninguna plantilla, es posible que tenga que instalar el componente de Windows Communication Foundation de Visual Studio. Para obtener más información, consulte Requisitos previos.

3. En la página Configurar el nuevo proyecto , compruebe la configuración y, a continuación, seleccione Crear.

   Este paso crea un servicio WCF en funcionamiento que puede probar y acceder. En los pasos siguientes se muestra cómo modificar el método predeterminado para usar un tipo de datos diferente. En una aplicación real, también deberías añadir tus propias funciones al servicio.

4. En el Explorador de soluciones, haga doble clic en IService1.cs o IService1.vb en el proyecto de biblioteca de servicios de WCF, en función del tipo de proyecto que creó.

   

5. Busque la siguiente línea:

   C#

   [OperationContract]
   string GetData(int value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As Integer) As String
   

---

6. Cambie el tipo del value parámetro a string.

   En este ejemplo de código, anote el OperationContract atributo . Este atributo es necesario para cualquier método expuesto por el servicio.

   C#

   [OperationContract]
   string GetData(string value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As String) As String
   

---

7. En el Explorador de soluciones, haga doble clic en Service1.cs o Service1.vb.

   

8. En el editor, busque la siguiente línea:

   C#

   public string GetData(int value)
   {
       return string.Format("You entered: {0}", value);
   }
   

   VB

   Public Function GetData(ByVal value As Integer) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

9. Cambie el tipo del value parámetro a string, como se indica a continuación:

   C#

   public string GetData(string value)
   {
       return string.Format("You entered: {0}", value);
   }
   

   VB

   Public Function GetData(ByVal value As String) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

Prueba del servicio WCF

Para probar el servicio WCF que creó, siga estos pasos:

1. Presione F5 para ejecutar el servicio.

   Aparece el formulario Cliente de prueba de WCF y carga el servicio.

2. En IService1, haga doble clic en el método GetData().

   La pestaña GetData aparece en el formulario cliente de prueba de WCF .

   

3. En el cuadro Solicitud de la pestaña GetData , seleccione el campo Valor y escriba Hello.

   

4. Seleccione el botón Invocar . Si aparece un cuadro de diálogo Advertencia de seguridad , seleccione Aceptar.

   El resultado se muestra en el cuadro Respuesta .

   

5. En el menú Archivo , seleccione Salir para cerrar el formulario de prueba.

Acceso al servicio WCF

Después de crear y probar el servicio WCF, puede hacer referencia a él desde un proyecto y usarlo para compilar una aplicación cliente.

Referencia al servicio WCF

Para hacer referencia al servicio WCF desde un proyecto, siga estos pasos:

1. Seleccione Archivo>Agregar>nuevo proyecto.

2. En la ventana Agregar un nuevo proyecto , elija un proyecto de Aplicación de Windows Forms (.NET Framework) de C# o Visual Basic. Seleccione Siguiente y, a continuación, Crear para crear el proyecto.

3. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto nuevo y seleccione Agregar>referencia de servicio.

   Aparece el cuadro de diálogo Agregar referencia de servicio .

4. Seleccione Descubrir.

   

   Service1 se muestra en el panel Servicios .

5. Seleccione Aceptar para agregar la referencia de servicio.

Compilación de una aplicación cliente

Para usar una referencia de servicio WCF para compilar una aplicación cliente, siga estos pasos.

1. En el Explorador de soluciones, haga doble clic en Form1.cs o Form1.vb en la aplicación windows Forms.

   El formulario se abre en el Diseñador de Windows Forms.

2. Para abrir el cuadro de herramientas , seleccione Ver>cuadro de herramientas en el menú o presione Ctrl+Alt+X en el teclado.

3. En el Cuadro de herramientas, arrastre un control TextBox , un control Label y un control Button al formulario.

   

4. Haga doble clic en el control Botón y agregue el código siguiente en el controlador de Click eventos:

   C#

   private void button1_Click(System.Object sender, System.EventArgs e)
   {
       ServiceReference1.Service1Client client = new
           ServiceReference1.Service1Client();
       string returnString;
   
       returnString = client.GetData(textBox1.Text);
       label1.Text = returnString;
   }
   

   VB

     Private Sub Button1_Click(ByVal sender As System.Object, _
   ByVal e As System.EventArgs) Handles Button1.Click
         Dim client As New ServiceReference1.Service1Client
         Dim returnString As String
   
         returnString = client.GetData(TextBox1.Text)
         Label1.Text = returnString
     End Sub
   

5. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto (por ejemplo, WindowsFormsApp1) y seleccione Establecer como proyecto de inicio.

6. Pulse F5 para ejecutar el proyecto. Escriba algún texto y seleccione el botón. La etiqueta muestra You entered:, seguido del texto.

   

Contenido relacionado

• Windows Communication Foundation Services y WCF Data Services en Visual Studio