與 ASMX Web 服務交互操作

發行項
05/22/2023

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

注意

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

這個範例是由用戶端主控台程式 (.exe) 和網際網路資訊服務 (IIS) 所裝載的服務程式庫 (.dll) 所組成。此服務是 ASMX Web 服務，會實作定義要求-回覆通訊模式的合約。此服務會公開數學作業 (Add、Subtract、Multiply 和 Divide)。用戶端會對數學運算作業提出同步要求，服務則會以結果回覆。您可以在主控台視窗中看到用戶端活動。

下列範例程式碼中示範的 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.

若要安裝、建置及執行範例

確定您已執行 Windows Communication Foundation 範例的一次性安裝程序。
若要建置方案的 C# 或 Visual Basic .NET 版本，請遵循 Building the Windows Communication Foundation Samples中的指示。
若要在單一或多部電腦組態中執行此範例，請遵循執行 Windows Communication Foundation 範例中的指示進行。

與 ASMX Web 服務交互操作

若要安裝、建置及執行範例

其他資源