共用方式為


與 ASMX Web 服務互作

ASMX 範例示範如何將 Windows Communication Foundation (WCF) 用戶端應用程式與現有的 ASMX Web 服務整合。

備註

此範例的安裝程式和建置指示位於本主題結尾。

此範例包含由 Internet Information Services (IIS) 裝載的用戶端控制台程式(.exe)和服務連結庫(.dll)。 服務是 ASMX Web 服務,可實作定義要求-回復通訊模式的合約。 服務會公開數學運算 (Add、、 SubtractMultiplyDivide)。 用戶端會向數學運算提出同步要求,而服務會以結果回復。 主控台視窗中會顯示客戶端活動。

下列範例程式代碼所示的 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 服務必須可供產生 Proxy 程式代碼,因為它用來擷取更新的元數據。 在客戶端目錄的命令提示符下執行以下命令以生成類型化 Proxy。

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 範例 中的指示。