建置 Windows Communication Foundation 範例

Windows Communication Foundation (WCF) 範例可以使用 Visual Studio IDE 或命令列中的 msbuild 命令來建置。 本文將說明這兩個程序。

注意

在建置或執行任何 WCF 範例之前，請確定您已執行 Windows Communication Foundation 範例的一次性安裝程序。

若要使用命令提示字元建置範例

1. 開啟 Visual Studio 的開發人員命令提示字元，並瀏覽至範例安裝所在目錄位置下的語言特定子目錄。

2. 在命令列輸入 msbuild。 用戶端程式檔會建置至 client\bin，服務程式檔則建置至 service\bin。 如果服務是由 Internet Information Services (IIS) 裝載，則服務程式檔也會被複製到 servicemodelsamples 目錄及其 \bin 子目錄中。

注意

您必須在 %systemdrive%\inetpub\wwwroot 上設定 ACL 以將修改權限授予您用來執行的帳戶。 否則，有些建置後事件將會失敗。 或者，您也可以不去改變這些 ACL，而以系統管理員身分來執行 SDK 命令提示字元。

若要使用 Visual Studio 建置範例

1. 從 Visual Studio 中的 [檔案] 功能表，選取 [開啟]>[專案/方案]。 請巡覽至您安裝此範例的目錄之下語言特定的子目錄，然後按兩下 .sln 檔案圖示以在 Visual Studio 中開啟方案。

2. 從 [建置] 功能表，選取 [重新建置方案]。

   用戶端程式檔會建置至 client\bin，服務程式檔則建置至 service\bin。 如果服務是由 IIS 裝載，則服務程式檔也會被複製到 servicemodelsamples 目錄及其 \bin 子目錄中。

注意

您必須在 %systemdrive%\inetpub\wwwroot 上設定 ACL 以將修改權限授予您用來執行的帳戶。 否則，有些建置後事件將會失敗。 不過，您也可以不去改變這些 ACL，而以系統管理員身分來執行 SDK 命令提示字元或 Visual Studio。 有些 Visual Studio 動作 (例如將偵錯工具附加到 ASP.NET 工作處理序中) 同時要求具備系統管理員權限。

設定批次檔和指令碼

Setup.exe 和 Cleanup.exe 批次檔與指令碼應從 Visual Studio 的開發人員命令提示字元來執行。 數種設定與清除檔案會執行需要系統管理員權限才能執行與啟動的工作。

關於中繼資料端點的重要安全性資訊

為了避免意外洩露潛在的敏感服務中繼資料，Windows Communication Foundation (WCF) 服務的預設組態會停用中繼資料發行。 這個行為依預設為安全行為，但也表示您無法使用中繼資料匯入工具 (例如 Svcutil.exe) 來產生呼叫服務所需的用戶端程式碼，除非組態中已明確啟用服務的中繼發行行為。 為了讓範例的實驗順利進行，幾乎所有範例都會公開不安全的中繼資料發行端點。 未經驗證的匿名使用者可能可以使用這類端點，所以部署前必須小心謹慎，才能確保公開服務中繼資料是否適切。 如需如何發佈服務中繼資料的詳細資訊，請參閱中繼資料發佈行為範例。 如需保護中繼資料端點的範例，請參閱自訂安全中繼資料端點範例。

例外狀況處理

一般來說，這些範例不包含例外狀況處理，以便讓程式碼專注在範例主題上。 如需例外狀況處理的詳細資訊，請參閱預期的例外狀況範例。

使用 Svcutil 重新產生用戶端與組態

您可以使用 ServiceModel 中繼資料公用程式工具 (Svcutil.exe) 重新產生大部分範例的用戶端程式碼和組態。 某些範例需要您手動編輯組態。 例如，如果您使用 Svcutil.exe 針對使用用戶端憑證認證的範例重新產生組態，則您必須手動指定先前設定的認證。 某些範例使用特定的 Svcutil.exe 選項來影響產生的程式碼，而這些選項都會在特定的範例主題中加以指定。

若要重新產生用戶端與組態檔

1. 開啟 [SDK 命令提示字元]，並巡覽至安裝範例所在目錄位置下任一語言特定子目錄。

2. 如果服務是 Web 裝載的型別，請使用下列命令。

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

   如果服務是自我裝載的型別，請使用下列命令。

   svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.cs
   

   請將 http://localhost:8000/ServiceModelSamples/service.svc/mex 取代為自我裝載服務 mex 端點的位址。

   若要以 Visual Basic 型別來產生用戶端，請使用下列命令。

   svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb
   

   如果服務是自我裝載的型別，請使用下列命令。

   svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb
   

   注意

   若要略過用戶端組態的產生作業，請新增 /noConfig 選項。

另請參閱

• 執行 Windows Communication Foundation 範例
• ServiceModel 中繼資料公用程式工具 (Svcutil.exe)