Tutorial: Cómo usar un cliente Windows Communication Foundation

Artículo
06/14/2023

En este tutorial se describe la última de las cinco tareas necesarias para crear una aplicación Windows Communication Foundation (WCF) básica. Para obtener información general sobre los tutoriales, consulte Tutorial: Introducción a las aplicaciones Windows Communication Foundation.

Después de crear y configurar un proxy Windows Communication Foundation (WCF), cree una instancia de cliente y compile la aplicación cliente. A continuación, puede usarlo para comunicarse con el servicio WCF.

En este tutorial, aprenderá a:

Agregue código para usar el cliente WCF.
Pruebe el cliente WCF.

Agregue código para usar el cliente WCF

El código de cliente realiza los siguientes pasos:

Crea instancias del cliente WCF.
Llama a las operaciones de servicio desde el proxy generado.
Cierra el cliente una vez completada la llamada a la operación.

Abra el archivo Program.cs o Module1.vb en el proyecto GettingStartedHost y reemplace el código por el siguiente:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using GettingStartedClient.ServiceReference1;

namespace GettingStartedClient
{
    class Program
    {
        static void Main(string[] args)
        {
            //Step 1: Create an instance of the WCF proxy.
            CalculatorClient client = new CalculatorClient();

            // Step 2: Call the service operations.
            // Call the Add service operation.
            double value1 = 100.00D;
            double value2 = 15.99D;
            double result = client.Add(value1, value2);
            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

            // Call the Subtract service operation.
            value1 = 145.00D;
            value2 = 76.54D;
            result = client.Subtract(value1, value2);
            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

            // Call the Multiply service operation.
            value1 = 9.00D;
            value2 = 81.25D;
            result = client.Multiply(value1, value2);
            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

            // Call the Divide service operation.
            value1 = 22.00D;
            value2 = 7.00D;
            result = client.Divide(value1, value2);
            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

            // Step 3: Close the client to gracefully close the connection and clean up resources.
            Console.WriteLine("\nPress <Enter> to terminate the client.");
            Console.ReadLine();
            client.Close();
        }
    }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.ServiceModel
Imports GettingStartedClient.ServiceReference1

Module Module1

    Sub Main()
        ' Step 1: Create an instance of the WCF proxy.
        Dim Client As New CalculatorClient()

        ' Step 2: Call the service operations.
        ' Call the Add service operation.
        Dim value1 As Double = 100D
        Dim value2 As Double = 15.99D
        Dim result As Double = Client.Add(value1, value2)
        Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)

        ' Call the Subtract service operation.
        value1 = 145D
        value2 = 76.54D
        result = Client.Subtract(value1, value2)
        Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)

        ' Call the Multiply service operation.
        value1 = 9D
        value2 = 81.25D
        result = Client.Multiply(value1, value2)
        Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)

        ' Call the Divide service operation.
        value1 = 22D
        value2 = 7D
        result = Client.Divide(value1, value2)
        Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)

        ' Step 3: Close the client to gracefully close the connection and clean up resources.
        Console.WriteLine()
        Console.WriteLine("Press <Enter> to terminate the client.")
        Console.ReadLine()
        Client.Close()

    End Sub

End Module

Observe la instrucción using (para Visual C#) o Imports (para Visual Basic) que importa GettingStartedClient.ServiceReference1. Esta instrucción importa el código que Visual Studio generó con la función Agregar referencia de servicio. El código crea una instancia del proxy WCF y llama a cada una de las operaciones de servicio que expone el servicio de calculadora. A continuación, cierra el proxy y finaliza el programa.

Pruebe el cliente WCF

Pruebe la aplicación desde Visual Studio

Guarde y genere la solución.
Seleccione la carpeta GettingStartedClient y, a continuación, seleccione Establecer como proyecto de inicio en el menú contextual.
En Proyectos de inicio, seleccione GettingStartedClient en la lista desplegable y, a continuación, seleccione Ejecutar o pulse F5.

Pruebe la aplicación desde un símbolo del sistema

Abra un símbolo del sistema como administrador y, a continuación, vaya al directorio de la solución de Visual Studio.
Para iniciar el servicio: escriba GettingStartedHost\bin\Debug\GettingStartedHost.exe.

Para iniciar el cliente: abra otro símbolo del sistema, vaya al directorio de la solución de Visual Studio y escriba GettingStartedClient\bin\Debug\GettingStartedClient.exe.

GettingStartedHost.exe genera la siguiente salida:

The service is ready.
Press <Enter> to terminate the service.

Received Add(100,15.99)
Return: 115.99
Received Subtract(145,76.54)
Return: 68.46
Received Multiply(9,81.25)
Return: 731.25
Received Divide(22,7)
Return: 3.14285714285714

GettingStartedClient.exe genera la siguiente salida:

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <Enter> to terminate the client.

Pasos siguientes

Ya ha completado todas las tareas del tutorial de introducción a WCF. En este tutorial, ha aprendido a: