建置 Windows Communication Foundation 範例

您可以使用 Visual Studio 2005 或是從命令列使用 msbuild 命令來建置 Windows Communication Foundation (WCF) 範例。本主題將同時說明這兩個程序。

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

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

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

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

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

若要使用 Visual Studio 建置範例

1. 如果您是使用 Windows Vista 或 Windows Server 2008，且正在執行 Visual Studio 2005，則必須使用更高的權限來執行 Visual Studio。如果要執行這項操作，用滑鼠右鍵按一下 [開始] 功能表上的圖示，然後按一下 [以系統管理員身分執行]。

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

3. 選取 [建置] 功能表中的 [重新建置方案]。用戶端程式檔會建置至 client\bin，服務程式檔則建置至 service\bin。如果服務是由 IIS 裝載，則服務程式檔也會被複製到 servicemodelsamples 目錄及其 \bin 子目錄中。

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

設定批次檔和指令碼

Setup.exe 和 Cleanup.exe 批次檔與指令碼必須透過 SDK 命令提示字元來執行。數種設定與清除檔案會執行需要系統管理員權限才能執行與啟動的工作。

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

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

例外處理

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

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

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

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

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

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

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

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

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

   使用自我裝載服務的 Mex 端點位址來取代 https://localhost:8000/ServiceModelSamples/service.svc/mex。

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

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

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

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

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

請參閱

概念

執行 Windows Communication Foundation 範例

其他資源

ServiceModel Metadata Utility Tool (Svcutil.exe)

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.