HOW TO：將 ASP.NET Web 服務程式碼移轉至 Windows Communication Foundation

發行項
09/12/2008

下列程序會描述如何將 ASP.NET Web 服務移轉至 Windows Communication Foundation (WCF)。

程序

將 ASP.NET Web 服務程式碼移轉至 WCF

請確定已存有服務的一組完整測試。
針對服務產生 WSDL，並在存放服務的 .asmx 檔案之相同資料夾中儲存複本。
升級 ASP.NET Web 服務以使用 .NET 2.0。首先，在 IIS 中將 .NET Framework 2.0 部署至應用程式，然後使用 Visual Studio 2005 自動化程式碼轉換處理序，如將 Web 專案從 Visual Studio .NET 2002/2003 轉換到 Visual Studio 2005 的逐步指南 (本頁面可能為英文) 所述。執行這組測試。

提供 WebService 屬性之 Namespace 和 Name 參數的明確值 (如果尚未提供)。對 WebMethodAttribute 的 MessageName 參數執行一樣的動作。如果尚未針對將要求遞送至方法時所使用 SOAPAction HTTP 標頭提供明確值，請使用 SoapDocumentMethodAttribute 明確指定 Action 參數的預設值。

[WebService(Namespace = "http://tempuri.org/", Name = "Adder")]
public class Adder
{
     [WebMethod(MessageName = "Add")]
     [SoapDocumentMethod(Action = "http://tempuri.org/Add")]
     public double Add(SumInput input)
     {
          double sum = 0.00;
          foreach (double inputValue in input.Input)
          {
              sum += inputValue;
          }
      return sum;
     }
}

測試變更。

將類別的方法之本文中的獨立程式碼移至原始類別要使用的不同類別。

[WebService(Namespace = "http://tempuri.org/", Name = "Adder")]
public class Adder
{
     [WebMethod(MessageName = "Add")]
     [SoapDocumentMethod(Action = "http://tempuri.org/Add")]
     public double Add(SumInput input)
     {
          return new ActualAdder().Add(input);
     }
}

internal class ActualAdder
{
     internal double Add(SumInput input)
     {
          double sum = 0.00;
          foreach (double inputValue in input.Input)
          {
              sum += inputValue;
          }
      return sum;
     }
}

測試變更。
將參考新增至 WCF 組件 System.ServiceModel，並將 System.Runtime.Serialization 新增至 ASP.NET Web 服務專案。
執行 ServiceModel Metadata Utility Tool (Svcutil.exe)，以從 WSDL 產生 WCF 用戶端類別。將產生的類別模組新增至解決方案。

前一個步驟所產生的類別模組會包含介面定義。

[System.ServiceModel.ServiceContractAttribute()]
public interface AdderSoap
{
     [System.ServiceModel.OperationContractAttribute(
      Action="http://tempuri.org/Add", 
      ReplyAction="http://tempuri.org/Add")]
     AddResponse Add(AddRequest request);
}

修改 ASP.NET Web 服務類別的定義，如此會將類別定義為實作該介面，如下列程式碼範例所示。

[WebService(Namespace = "http://tempuri.org/", Name = "Adder")]
public class Adder: AdderSoap
{
     [WebMethod(MessageName = "Add")]
     [SoapDocumentMethod(Action = "http://tempuri.org/Add")]
     public double Add(SumInput input)
     {
          return new ActualAdder().Add(input);
     }

     public AddResponse Add(AddRequest request)
     {
        return new AddResponse(
        new AddResponseBody(
        this.Add(request.Body.input)));
     }
}

編譯專案。由於步驟九中產生的程式碼複製了某些型別定義，因此可能會出現一些錯誤。通常刪除預先存在的型別定義即可修復這些錯誤。測試變更。

移除 ASP.NET 特定的屬性，例如 WebService、WebMethodAttribute 和 SoapDocumentMethodAttribute。

public class Adder: AdderSoap
{
     public double Add(SumInput input)
     {
          return new ActualAdder().Add(input);
     }

     public AddResponse Add(AddRequest request)
     {
          return new AddResponse(
         new AddResponseBody(
        this.Add(request.Body.input)));
     }
}

如果 ASP.NET Web 服務依賴下列任一項，那麼請將類別 (目前為 WCF 服務類型) 設定為需要 WCF ASP.NET 相容模式：
- HttpContext 類別。
- ASP.NET 設定檔。
- 在 .asmx 檔案上的 ACL。
- IIS 驗證選項。
- ASP.NET 模擬選項。
- ASP.NET 全球化。
```
[System.ServiceModel.AspNetCompatibilityRequirements(
  RequirementsMode=AspNetCompatbilityRequirementsMode.Required)]
public class Adder: AdderSoap
```
將原始 .asmx 檔案重新命名為 .asmx.old。
對服務建立 WCF 服務檔，將副檔名設為 .asmx，然後儲存至 IIS 的應用程式根目錄中。
```
<%@Service Class="MyOrganization.Adder" %>
<%@Assembly Name="MyServiceAssembly" %> 
```

將服務的 WCF 組態新增至其 Web.config 檔。將服務設定為使用 basicHttpBinding Element，以使用之前的步驟中所建立副檔名為 .asmx 的服務檔，並不是產生自身的 WSDL，而是使用步驟二的 WSDL。必要時，也設定為使用 ASP.NET 相容模式。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
 <system.web>
  <compilation>
  <buildProviders>
   <remove extension=".asmx" />
   <add extension=".asmx" 
    type=
    "System.ServiceModel.Activation.ServiceBuildProvider,
    T:System.ServiceModel, Version=2.0.0.0, 
   Culture=neutral, 
   PublicKeyToken=b77a5c561934e089" />
  </buildProviders>
  </compilation>
 </system.web>
 <system.serviceModel>
  <services>
  <service name="MyOrganization.Adder "
    behaviorConfiguration="AdderBehavior">
   <endpoint 
    address="”
    binding="basicHttpBinding"
    contract="AdderSoap "/>
   </service>
  </services>
  <behaviors>
  <behavior name="AdderBehavior">
   <metadataPublishing 
    enableMetadataExchange="true" 
    enableGetWsdl="true" 
    enableHelpPage="true" 
    metadataLocation=
    "http://MyHost.com/AdderService/Service.WSDL"/>
  </behavior>
  </behaviors>
  <serviceHostingEnvironment 
   aspNetCompatibilityEnabled ="true"/>
 </system.serviceModel>
</configuration>

儲存組態。
編譯專案。
執行一組測試，以確定所有變更都已生效。

請參閱

工作

HOW TO：將 ASP.NET Web 服務用戶端程式碼移轉至 Windows Communication Foundation

共用方式為

HOW TO：將 ASP.NET Web 服務程式碼移轉至 Windows Communication Foundation

程序

將 ASP.NET Web 服務程式碼移轉至 WCF

請參閱

工作

其他資源