WCF Visual Studio 範本

Windows Communication Foundation (WCF) Visual Studio 範本是預先定義的專案和項目範本,可在 Visual Studio 中用來快速建置 WCF 服務和相關應用程式。

使用 WCF 範本

WCF Visual Studio 範本提供開發服務所需的基本類別結構。 具體來說,這些範本會提供服務合約、資料合約、服務實作和組態的基本定義。 您可以使用這些範本,建立具有最基本程式碼互動的簡單服務,以及適用於更進階服務的建置組塊。

WCF 服務程式庫專案範本

WCF 服務程式庫專案範本可以在 Visual C#\WCFVisual Basic\WCF 下的 [新增專案] 對話方塊中取得。

當您使用 [WCF 服務] 範本建立新專案時,新專案會自動包含下列三個檔案:

  • 服務合約檔案 (IService1.cs 或 IService1.vb)。 服務合約檔案是已套用 WCF 服務屬性的介面。 這個檔案提供簡單服務的定義以示範如何定義服務,而其中也包含以參數為基礎的作業和簡單的資料合約範例。 這是在建立 WCF 服務專案後,顯示於程式碼編輯器中的預設檔案。

  • 服務實作檔案 (Service1.cs 或 Service1.vb)。 服務實作檔案會實作服務合約檔案中定義的合約。

  • 應用程式組態檔案 (App.config)。 組態檔提供具有安全的 HTTP 繫結之 WCF 服務模型的基本項目。 它也包含服務的端點,並會啟用中繼資料交換。

注意

注意:當 Visual Studio 是使用 WCF 服務主機 (WcfSvcHost.exe) (此為預設組態) 來執行時,會設定成將 App.config 檔案識別為專案的組態檔。 如果是在可執行檔中裝載服務程式庫,您必須將組態程式碼移至該可執行檔的組態檔,因為 DLL 的組態檔是無效的。

WCF 服務應用程式範本

WCF 服務應用程式範本可以在 Visual C#\WCFVisual Basic\WCF 下的 [新增專案] 對話方塊中取得。

當您使用 [WCF Web 應用程式服務] 範本建立新專案時,這個專案會包含下列四個檔案:

  • 服務主機檔案 (service1.svc)。

  • 服務合約檔案 (IService1.cs 或 IService1.vb)。

  • 服務實作檔案 (Service1.svc.cs 或 Service1.svc.vb)。

  • Web 組態檔案 (Web.config)。

範本會自動建立網站 (這會部署到虛擬目錄中) 並在其中裝載服務。

WCF 網站範本

WCF 網站範本可在 Visual C#\Web Site\WCF ServiceVisual Basic\Web Site\WCF Service 下的 [新增專案] 對話方塊中取得。 這會建立與 WCF 服務應用程式範本相同的檔案,但是其組織方式猶如 ASP.NET 網站。 會建立 App_Code 和 App_Data 資料夾。

WCF 服務項目範本

WCF 服務項目範本是自訂範本,可提供用來加入 WCF 服務至現有 Visual Studio 專案的快速方式。

若要使用這個範本,請移至 [方案總管] 窗格,以滑鼠右鍵按一下專案名稱,指向 [新增],然後按一下 [加入新項目] 以啟動 [新增項目] 對話方塊。

服務介面和實作檔案會放置在根專案資料夾。

如果新服務的組態區段和現有組態檔屬於相容的類型,則範本會嘗試加以合併。

如果現有專案是 Web 專案,也會建立服務主機檔案 (service1.svc)。

WCF WF 服務專案和項目範本。

這些範本會建立裝載工作流程服務的 WCF 服務,這個工作流程可以當做像是 Web 服務一般來存取。 XAML 或命令式程式撰寫模型各有不同的範本。 您可以使用這些範本來建立循序或狀態機器工作流程。 如需這些工作流程型別的詳細資訊,請參閱操作說明:建立工作流程。 如需建立工作流程專案的詳細資訊,請參閱建立舊版工作流程專案

當您使用 XOML 型別的工作流程,而不使用以程式碼為主的工作流程時,Visual Studio 設計工具的回應會更為迅速。 XOML 工作流程是預設要建立的工作流程類型。

WCF 新聞訂閱服務程式庫範本

這個範本可讓您將 RSS 或 ATOM 格式的摘要公開為 WCF 服務。 如需詳細資訊,請參閱 WCF 摘要整合

變更摘要的位址

摘要整合範本會在執行期間使用網頁瀏覽器。 當您以滑鼠右鍵按一下 Visual Studio 的 [方案總管] 中的專案,然後選取 [屬性],再選取 [偵錯] 索引標籤,您會看到範本的預設位址。 瀏覽器會嘗試開啟這個位址上的摘要。

如果您要變更摘要的位址,您必須也變更 [偵錯] 索引標籤中的位址。如果您沒有這麼做,瀏覽器會嘗試開啟預設位址上的摘要,但將無法開啟。

具備 AJAX 能力的 WCF 服務項目範本

這個範本會將 AJAX 控制項公開為 WCF 服務。 如需 AJAX 控制項的詳細資訊,請參閱 AJAX 控制項文件 (英文)。

啟用 Silverlight 的 WCF 服務項目範本

這個範本會建立提供資料給 Silverlight 用戶端或前端的 Web 服務。 這個範本可以加入至網站或 Web 應用程式專案來建立 WCF 服務,其中包括支援與 Silverlight 用戶端進行通訊的服務程式碼和組態。 您可以接著使用 [加入服務參考] 將服務的用戶端 Proxy 加入至用戶端,並且在 Silverlight 用戶端和啟用 Silverlight 的 WCF 服務之間交換資料。

若要存取這個範本,請以滑鼠右鍵按一下 [方案總管] 中的網站或 Web 應用程式專案,然後按一下 [加入新項目],再按一下 [啟用 Silverlight 的 WCF 服務]

注意

啟用 Silverlight 的 WCF 服務會在不啟用任何安全性設定的情況下公開 basicHttpBinding 端點。 因此,所有連接到這個服務的用戶端,都可以取得此服務的相關資訊。 同樣地,服務和用戶端之間的交換訊息也不會經過簽署或加密。 為了確保端點安全性,您應該使用 ASP.NET 驗證、HTTPS 或其他機制。

另請參閱