Tutorial: Como utilizar o cliente Windows Communication Foundation

Artigo
06/16/2023

Este tutorial descreve a última de cinco tarefas necessárias para criar um aplicativo básico do Windows Communication Foundation (WCF). Para obter uma visão geral dos tutoriais, consulte Tutorial: Introdução aos aplicativos do Windows Communication Foundation.

Depois de criar e configurar um proxy do WCF (Windows Communication Foundation), crie uma instância do cliente e compile o aplicativo cliente. Em seguida, use-o para se comunicar com o serviço WCF.

Neste tutorial, você aprenderá a:

Adicionar código para usar o cliente WCF.
Testar o cliente WCF.

Adicionar código para usar o cliente WCF

O código cliente segue as seguintes etapas:

Instancia o cliente WCF.
Chama as operações de serviço do proxy gerado.
Fecha o cliente depois que a chamada de operação é concluída.

Abra o arquivo Program.cs ou Module1.vb no projeto GettingStartedClient e substitua o código do projeto pelo seguinte:

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 a instrução using (para Visual C#) ou Imports (para Visual Basic) que importa GettingStartedClient.ServiceReference1. Esta instrução importa o código gerado pelo Visual Studio com a função Adicionar Referência de Serviço. O código cria uma instância do proxy do WCF e chama cada uma das operações de serviço que o serviço de calculadora expõe. Em seguida, ele fecha o proxy e encerra o programa.

Testar o cliente WCF

Testar o aplicativo do Visual Studio

Salve e crie a solução.
Selecione a pasta GettingStartedClient e Definir como Projeto de Inicialização no menu de atalho.
Em Projetos de Inicialização, selecione GettingStartedClient na lista suspensa e escolha Executar ou pressione F5.

Testar o aplicativo em um prompt de comando

Abra um prompt de comando como administrador e navegue até o diretório de solução do Visual Studio.
Para iniciar o serviço: insira GettingStartedHost\bin\Debug\GettingStartedHost.exe.

Para iniciar o cliente: abra outro prompt de comando, navegue até o diretório de solução do Visual Studio e insira GettingStartedClient\bin\Debug\GettingStartedClient.exe.

GettingStartedHost.exe produz a seguinte saída:

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 produz a seguinte saída:

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.

Próximas etapas

Agora você concluiu todas as tarefas no tutorial de introdução do WCF. Neste tutorial, você aprendeu a: