如何：在程式代碼中指定客戶端系結

在此範例中，會建立用戶端以使用計算機服務，並在程式代碼中以命令方式指定該客戶端的系結。用戶端會存取 CalculatorService，該CalculatorService實作了 BasicHttpBinding 介面，並且服務和用戶端都會使用類別。

此程式假設計算機服務正在執行。如需建置服務的相關信息，請參閱如何：在組態中指定服務系結。它也會使用 ServiceModel 元數據公用程式工具（Svcutil.exe）Windows Communication Foundation （WCF）來自動產生用戶端元件。此工具會產生用來存取服務的用戶端程序代碼。

用戶端內建兩個部分。 Svcutil.exe 生成實作 ClientCalculator 介面的 ICalculator。接著，此用戶端應用程式會藉由建構的 ClientCalculator 實例，然後在程式代碼中指定服務的系結和位址來建構。

如需此範例的來源複本，請參閱 BasicBinding 範例。

在程式代碼中指定自定義系結

從命令行使用 Svcutil.exe，從服務元數據產生程序代碼。

Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>

產生的用戶端包含 ICalculator 介面，定義用戶端實作必須滿足的服務合約。

[ServiceContract]
public interface ICalculator
{
   [OperationContract]
   double Add(double n1, double n2);
   [OperationContract]
   double Subtract(double n1, double n2);
   [OperationContract]
   double Multiply(double n1, double n2);
   [OperationContract]
   double Divide(double n1, double n2);
}

<ServiceContract()> _
Public Interface ICalculator

    <OperationContract()> _
    Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double

    <OperationContract()> _
    Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double

    <OperationContract()> _
    Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double

    <OperationContract()> _
    Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double

End Interface

產生的用戶端也包含ClientCalculator的實作。


public class CalculatorClient : System.ServiceModel.ClientBase<Microsoft.ServiceModel.Samples.ICalculator>, Microsoft.ServiceModel.Samples.ICalculator
{

    public CalculatorClient()
    {
    }

    public CalculatorClient(string endpointConfigurationName) :
            base(endpointConfigurationName)
    {
    }

    public CalculatorClient(string endpointConfigurationName, string remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public CalculatorClient(string endpointConfigurationName, EndpointAddress remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public CalculatorClient(Binding binding, EndpointAddress remoteAddress) :
            base(binding, remoteAddress)
    {
    }

    public double Add(double n1, double n2)
    {
        return base.Channel.Add(n1, n2);
    }

    public double Subtract(double n1, double n2)
    {
        return base.Channel.Subtract(n1, n2);
    }

    public double Multiply(double n1, double n2)
    {
        return base.Channel.Multiply(n1, n2);
    }

    public double Divide(double n1, double n2)
    {
        return base.Channel.Divide(n1, n2);
    }
}

Public Class CalculatorClient
    Inherits System.ServiceModel.ClientBase(Of Microsoft.ServiceModel.Samples.ICalculator)
    Implements Microsoft.ServiceModel.Samples.ICalculator

    Public Sub New()
    End Sub

    Public Sub New(ByVal endpointConfigurationName As String)
        MyBase.New(endpointConfigurationName)
    End Sub

    Public Sub New(ByVal endpointConfigurationName As String, _
                   ByVal remoteAddress As String)
        MyBase.New(endpointConfigurationName, remoteAddress)
    End Sub

    Public Sub New(ByVal endpointConfigurationName As String, _
                   ByVal remoteAddress As EndpointAddress)
        MyBase.New(endpointConfigurationName, remoteAddress)
    End Sub

    Public Sub New(ByVal binding As Binding, _
                   ByVal remoteAddress As EndpointAddress)
        MyBase.New(binding, remoteAddress)
    End Sub

    Public Function Add(ByVal n1 As Double, _
                        ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Add
        Return MyBase.Channel.Add(n1, n2)
    End Function

    Public Function Subtract(ByVal n1 As Double, _
                             ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Subtract
        Return MyBase.Channel.Subtract(n1, n2)
    End Function

    Public Function Multiply(ByVal n1 As Double, _
                             ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Multiply
        Return MyBase.Channel.Multiply(n1, n2)
    End Function

    Public Function Divide(ByVal n1 As Double, _
                           ByVal n2 As Double) As Double Implements Microsoft.ServiceModel.Samples.ICalculator.Divide
        Return MyBase.Channel.Divide(n1, n2)
    End Function

End Class

在用戶端應用程式中建立使用 BasicHttpBinding 類別的 ClientCalculator 實例，然後在指定的位址呼叫服務作業。


    //Client implementation code.
    class Client
    {
        static void Main()
        {

            //Specify the binding to be used for the client.
            BasicHttpBinding binding = new BasicHttpBinding();

            //Specify the address to be used for the client.
            EndpointAddress address =
               new EndpointAddress("http://localhost/servicemodelsamples/service.svc");

            // Create a client that is configured with this address and binding.
            CalculatorClient client = new CalculatorClient(binding, address);

            // Call the Add service operation.
            double value1 = 100.00D;
            double value2 = 15.99D;
            double result = client.Add(value1, value2);
            Console.WriteLine($"Add({value1},{value2}) = {result}");

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

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

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

            //Closing the client gracefully closes the connection and cleans up resources
            client.Close();

            Console.WriteLine();
            Console.WriteLine("Press <ENTER> to terminate client.");
            Console.ReadLine();
        }
    }
}


    'Client implementation code.
    Friend Class Client
        Shared Sub Main()

            'Specify the binding to be used for the client.
            Dim binding As New BasicHttpBinding()

            'Specify the address to be used for the client.
            Dim address As New EndpointAddress("http://localhost/servicemodelsamples/service.svc")


            ' Create a client that is configured with this address and binding.
            Dim client As New CalculatorClient(binding, address)

            ' Call the Add service operation.
            Dim value1 = 100.0R
            Dim value2 = 15.99R
            Dim result = client.Add(value1, value2)
            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)

            ' Call the Subtract service operation.
            value1 = 145.0R
            value2 = 76.54R
            result = client.Subtract(value1, value2)
            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)

            ' Call the Multiply service operation.
            value1 = 9.0R
            value2 = 81.25R
            result = client.Multiply(value1, value2)
            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)

            ' Call the Divide service operation.
            value1 = 22.0R
            value2 = 7.0R
            result = client.Divide(value1, value2)
            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)

            'Closing the client gracefully closes the connection and cleans up resources
            client.Close()

            Console.WriteLine()
            Console.WriteLine("Press <ENTER> to terminate client.")
            Console.ReadLine()
        End Sub
    End Class
End Namespace

編譯並執行用戶端。

另請參閱

使用系結設定服務和用戶端

Last updated on 2025-04-10

共用方式為

如何：在程式代碼中指定客戶端系結

在程式代碼中指定自定義系結

另請參閱

其他資源