Samouczek: korzystanie z klienta programu Windows Communication Foundation

Artykuł
03/05/2024

W tym samouczku opisano ostatnie z pięciu zadań wymaganych do utworzenia podstawowej aplikacji windows Communication Foundation (WCF). Aby zapoznać się z omówieniem samouczków, zobacz Samouczek: rozpoczynanie pracy z aplikacjami Windows Communication Foundation.

Po utworzeniu i skonfigurowaniu serwera proxy programu Windows Communication Foundation (WCF) należy utworzyć wystąpienie klienta i skompilować aplikację kliencką. Następnie użyjesz go do komunikowania się z usługą WCF.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

Dodaj kod, aby używać klienta WCF.
Przetestuj klienta programu WCF.

Dodawanie kodu do korzystania z klienta WCF

Kod klienta wykonuje następujące czynności:

Tworzy wystąpienie klienta programu WCF.
Wywołuje operacje usługi z wygenerowanego serwera proxy.
Zamyka klienta po zakończeniu wywołania operacji.

Otwórz plik Program.cs lub Module1.vb z projektu GettingStartedClient i zastąp jego kod następującym kodem:

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

Zwróć uwagę na instrukcję using (dla języka Visual C#) lub Imports (dla języka Visual Basic), która importuje GettingStartedClient.ServiceReference1element . Ta instrukcja importuje kod wygenerowany przez program Visual Studio z funkcją Add Service Reference (Dodawanie odwołania do usługi). Kod tworzy wystąpienie serwera proxy WCF i wywołuje każdą operację usługi uwidacznianą przez usługę kalkulatora. Następnie zamyka serwer proxy i kończy program.

Testowanie klienta WCF

Testowanie aplikacji z poziomu programu Visual Studio

Zapisz i skompiluj rozwiązanie.
Wybierz folder GettingStartedClient, a następnie wybierz pozycję Ustaw jako projekt startowy z menu skrótów.
W obszarze Projekty startowe wybierz pozycję GettingStartedClient z listy rozwijanej, a następnie wybierz pozycję Uruchom lub naciśnij klawisz F5.

Testowanie aplikacji z poziomu wiersza polecenia

Otwórz wiersz polecenia jako administrator, a następnie przejdź do katalogu rozwiązania programu Visual Studio.
Aby uruchomić usługę: wprowadź ciąg GettingStartedHost\bin\Debug\GettingStartedHost.exe.

Aby uruchomić klienta: Otwórz inny wiersz polecenia, przejdź do katalogu rozwiązania programu Visual Studio, a następnie wprowadź ciąg GettingStartedClient\bin\Debug\GettingStartedClient.exe.

GettingStartedHost.exe generuje następujące dane wyjściowe:

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 generuje następujące dane wyjściowe:

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.

Następne kroki

Wszystkie zadania zostały ukończone w samouczku wprowadzenie do programu WCF. W tym samouczku zawarto informacje na temat wykonywania następujących czynności: