与 ASMX Web 服务互作

ASMX 示例演示如何将 Windows Communication Foundation (WCF) 客户端应用程序与现有的 ASMX Web 服务集成。

注释

本示例的设置过程和生成说明位于本主题末尾。

此示例由 Internet 信息服务(IIS)托管的客户端控制台程序(.exe)和服务库(.dll)组成。 该服务是一个 ASMX Web 服务,它实现定义请求-回复通信模式的协定。 该服务公开数学运算(AddSubtractMultiplyDivide)。 客户端向数学运算发出同步请求,服务会回复结果。 客户端活动在控制台窗口中可见。

以下示例代码中显示的 ASMX Web 服务实现计算并返回相应的结果。

[WebService(Namespace="http://Microsoft.ServiceModel.Samples")]
public class CalculatorService : System.Web.Services.WebService
    {
        [WebMethod]
        public double Add(double n1, double n2)
        {
            return n1 + n2;
        }
        [WebMethod]
        public double Subtract(double n1, double n2)
        {
            return n1 - n2;
        }
        [WebMethod]
        public double Multiply(double n1, double n2)
        {
            return n1 * n2;
        }
        [WebMethod]
        public double Divide(double n1, double n2)
        {
            return n1 / n2;
        }
    }

配置后,同一计算机上的客户端可以在http://localhost/servicemodelsamples/service.asmx访问该服务。 若要使远程计算机上的客户端访问服务,必须指定限定的域名,而不是 localhost。

通信是通过 ServiceModel 元数据实用工具工具(Svcutil.exe)生成的客户端完成的。 客户端包含在文件generatedClient.cs中。 ASMX 服务必须可用于生成代理代码,因为它用于检索更新的元数据。 从客户端目录中的命令提示符运行以下命令以生成类型化的代理。

svcutil.exe /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples http://localhost/servicemodelsamples/service.svc?wsdl /out:generatedClient.cs

通过使用生成的客户端,可以通过配置相应的地址和绑定来访问服务终结点。 与服务一样,客户端使用配置文件(App.config)指定要与之通信的终结点。 客户端终结点配置由服务终结点、绑定和协定的绝对地址组成,如以下示例配置所示。

<client>
   <endpoint
      address="http://localhost/ServiceModelSamples/service.asmx"
      binding="basicHttpBinding"
      contract="Microsoft.ServiceModel.Samples.CalculatorServiceSoap" />
</client>

客户端实现构造生成的客户端的实例。 然后,生成的客户端可用于与服务通信。

// Create a client.
CalculatorServiceSoapClient client = new CalculatorServiceSoapClient();

// 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();

运行示例时,操作请求和响应将显示在客户端控制台窗口中。 在客户端窗口中按 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 示例中的说明进行操作。