具有 WCF 服务的 ASMX 客户端

ASMX 示例演示如何使用 Windows Communication Foundation （WCF） 创建服务，然后从非 WCF 客户端（如 ASMX 客户端）访问服务。

此示例由 Internet 信息服务（IIS）托管的客户端控制台程序（.exe）和服务库（.dll）组成。 该服务实现定义请求-回复通信模式的协定。 协定由ICalculator接口定义，该接口公开数学运算（Add、Subtract和MultiplyDivide）。 ASMX 客户端向数学运算发出同步请求，服务会回复结果。

该服务实现 ICalculator 以下代码中定义的协定。

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"), XmlSerializerFormat]
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);
}

DataContractSerializer和XmlSerializer将 CLR 类型映射到 XML 表示形式。 DataContractSerializer 以不同于 XmlSerializer 的方式解释某些 XML 表示形式。 使用 XmlSerializer 时，非 WCF 代理生成器（如 Wsdl.exe）生成更可用接口。 该 XmlSerializerFormatAttribute 接口应用于 ICalculator 接口，以确保 XmlSerializer 用于将 CLR 类型映射到 XML。 服务实现计算并返回相应的结果。

该服务公开一个终结点，用于与服务通信，该终结点使用配置文件（Web.config）定义。 终结点由地址、绑定和协定组成。 服务在 Internet 信息服务 (IIS) 主机提供的基地址公开该终结点。 该 binding 属性设置为 basicHttpBinding，它使用 SOAP 1.1 提供 HTTP 通信，该通信符合 WS-I BasicProfile 1.1，如以下示例配置所示。

<services>
  <service name="Microsoft.ServiceModel.Samples.CalculatorService"
           behaviorConfiguration="CalculatorServiceBehavior">
    <!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc.  -->
    <endpoint address=""
              binding="basicHttpBinding"
              contract="Microsoft.ServiceModel.Samples.ICalculator" />
  </service>
</services>

ASMX 客户端使用 Web 服务描述语言（WSDL）实用工具（Wsdl.exe）生成的类型代理与 WCF 服务通信。 类型化代理包含在文件 generatedClient.cs 中。 WSDL 实用工具检索指定服务的元数据，并生成一个类型化代理供客户端通信。 默认情况下，框架不会公开任何元数据。 若要公开生成代理所需的元数据，必须添加 <serviceMetadata> 并将其 httpGetEnabled 属性设置为 True 以下配置所示。

<behaviors>
  <serviceBehaviors>
    <behavior name="CalculatorServiceBehavior">
      <!-- Setting httpGetEnabled to True on the serviceMetadata
           behavior exposes the service's wsdl at <base address>?wsdl :
           http://localhost/servicemodelsamples/service.svc?wsdl -->
      <serviceMetadata httpGetEnabled="True"/>
      <serviceDebug includeExceptionDetailInFaults="False" />
    </behavior>
  </serviceBehaviors>
</behaviors>

从客户端目录中的命令提示符运行以下命令以生成类型化的代理。

wsdl /n:Microsoft.ServiceModel.Samples /o:generatedClient.cs /urlkey:CalculatorServiceAddress http://localhost/servicemodelsamples/service.svc?wsdl

通过使用生成的类型代理，客户端可以通过配置相应的地址来访问给定的服务终结点。 客户端使用配置文件（App.config）指定要与之通信的终结点。

<appSettings>
  <add key="CalculatorServiceAddress"
       value="http://localhost/ServiceModelSamples/service.svc"/>
</appSettings>

客户端实现构造类型化代理的实例，以开始与服务通信。

// Create a client to the CalculatorService.
using (CalculatorService client = new CalculatorService())
{
    // 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);

}

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

运行示例时，操作请求和响应将显示在客户端控制台窗口中。 在客户端窗口中按 Enter 关闭客户端。

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 client.

设置、生成和运行示例

1. 确保已为 Windows Communication Foundation 示例 执行One-Time 安装过程。

2. 若要生成解决方案的 C# 或 Visual Basic .NET 版本，请按照 生成 Windows Communication Foundation 示例中的说明进行操作。

3. 若要在单台计算机或跨计算机配置中运行示例，请按照 运行 Windows Communication Foundation 示例中的说明进行操作。