如何:在代码中指定客户端绑定
在本示例中,创建了一个使用计算器服务的客户端,并在代码中以强制方式指定该客户端的绑定。该客户端访问实现了 ICalculator 接口的 CalculatorService,并且服务和客户端都使用 BasicHttpBinding 类。
此过程假设计算器服务正在运行。有关生成该服务的信息,请参见如何:在配置中指定服务绑定。此过程还使用 Windows Communication Foundation (WCF) 提供的 ServiceModel 元数据实用工具 (Svcutil.exe) 来自动生成客户端组件。该工具生成用于访问服务的客户端代码。
客户端分两部分生成。Svcutil.exe 生成实现 ICalculator 接口的 ClientCalculator。然后,通过构造 ClientCalculator 的一个实例,并在代码中指定服务的绑定和地址,构造此客户端应用程序。
有关此示例的源代码副本,请参见BasicBinding示例。
在代码中指定自定义绑定
在命令行中,使用 Svcutil.exe 根据服务元数据生成代码。
Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>
生成的客户端包含 ICalculator 接口,该接口定义了客户端实现必须满足的服务协定。
<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
[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); }
生成的客户端还包含 ClientCalculator 的实现。
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
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); } }
创建 ClientCalculator 的一个实例(该实例在客户端应用程序中使用 BasicHttpBinding 类),然后调用指定地址上的服务操作。
'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("https://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
//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("https://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({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); //Closing the client gracefully closes the connection and cleans up resources client.Close(); Console.WriteLine(); Console.WriteLine("Press <ENTER> to terminate client."); Console.ReadLine(); } } }
编译并运行客户端。