共用方式為


產生 WCF 用戶端或 SQL Server 成品的 WCF 服務合約

您可以使用 [新增配接器服務參考 Visual Studio 外掛程式] 來產生以SQL Server成品上所選作業為目標的 WCF 用戶端類別。 您也可以使用 ServiceModel 中繼資料公用程式工具 (svcutil.exe) 來產生 WCF 用戶端類別;不過,新增配接器服務參考外掛程式會透過標準 Microsoft Windows 介面公開 ServiceModel 中繼資料公用程式工具的功能。 它也提供 svcutil.exe 工具無法使用的流覽和搜尋功能,並根據您連接到 SQL Server 資料庫時選取的系結屬性產生組態檔。

使用新增配接器服務參考外掛程式產生 WCF 用戶端類別

執行下列步驟,以使用新增配接器服務參考外掛程式來產生 WCF 用戶端類別。

  1. 在 Visual Studio 方案總管中,以滑鼠右鍵按一下您的專案,然後按一下 [新增配接器服務參考]。

  2. 在 [新增配接器服務參考] 對話方塊開啟之後,請遵循使用 SQL 配接器連線到SQL Server和流覽和搜尋作業,在 Visual Studio 中取得SQL Server作業中繼資料中的步驟。 若要為您所選取的作業建立 WCF 用戶端類別,請確定已從 [選取合約類型] 下拉式清單中選取 [用戶端 (輸出作業) 。 (這是預設) 。

  3. 選取您想要鎖定的所有作業之後,按一下 [ 確定 ] 以產生 WCF 用戶端類別。

    [新增配接器服務參考外掛程式] 會將兩個檔案新增至您的專案:

  • WCF 用戶端程式代碼檔案。 此檔案包含您所選取之作業的產生的 WCF 用戶端類別和協助程式程式碼。 第一次執行 [新增配接器服務參考 Visual Studio 外掛程式] 時,它會使用預設名稱 SQLAdapterBindingClient.cs產生此檔案。 如果您再次執行它,其產生的下一個檔案會稱為 SQLAdapterBindingClient1.cs。 每個您產生之新檔案的數位尾碼都會增加 1。 您也可以在 [新增配接器服務參考 Visual Studio 外掛程式] 的 [檔案名前置詞] 欄位中輸入不同的前置詞,然後選取 [確定] 來產生檔案,以變更預設前置詞SQLBinding

  • App.config。此檔案包含系結組態和用戶端端點組態,這些組態是以您在設定 [新增配接器服務參考外掛程式] 連線時所做的選取專案為基礎。

    重要

    使用 [新增配接器服務參考外掛程式] 時,如果您未為字串類型的系結屬性指定值,且其預設值為 null,則該系結屬性將無法在 app.config 檔案中使用。 如有必要,您必須在 app.config 檔案中手動新增系結屬性及其值。

使用新增配接器服務參考外掛程式產生 WCF 服務合約

針對輪詢SQL Server資料庫或從資料庫接收通知等輸入作業,SQL 配接器會在輪詢) 時執行用戶端應用程式所指定的查詢 (,或在通知) 時向SQL Server (註冊查詢。 在這兩種情況下,配接器會將輸入訊息從 SQL Server 資料庫傳送至取用。 在這種情況下,取用的應用程式會作為服務,而 SQL 配接器會作為用戶端。 因此,您必須實作可從配接器接收輸入作業的 WCF 服務。 若要這樣做,您可以使用 [新增配接器服務參考外掛程式] 來產生 .NET 介面,代表配接器針對輸入作業呈現的服務合約。 這個 .NET 介面也稱為 WCF 服務合約。 接著,您可以實作此介面來建立可用來接收輸入作業的 WCF 服務。

執行下列步驟,以使用新增配接器服務參考外掛程式來產生 WCF 服務合約。

產生輸入作業的 WCF 服務合約

  1. 在 Visual Studio 方案總管中,以滑鼠右鍵按一下您的專案,然後按一下 [新增配接器服務參考]。

  2. 在 [新增配接器服務參考] 對話方塊開啟之後,請遵循使用 [新增配接器服務參考外掛程式] 連接到 SQL Server 資料庫中的 [連線到 Visual Studio 中的SQL Server中的步驟。

    重要

    如果您要為 TypedPolling 輸入作業產生 WCF 服務合約,則必須將 InboundID 指定為連線 URI 和 PollingStatement 系結屬性的一部分。

  3. 連線到SQL Server資料庫之後,請從 [選取合約類型] 下拉式清單中選取 [服務 (輸入作業)

  4. 在 [ 選取類別] 方塊中,按一下根節點 (/) ,從 [ 可用的類別和作業 ] 方塊中選取輸入作業,然後按一下 [ 新增]。

  5. 若要產生輸入作業的 WCF 服務合約,請按一下 [ 確定]。

    [新增配接器服務參考外掛程式] 會將三個檔案新增至您的專案:

  • SqlAdapterBindingInterface.cs。 此檔案包含產生的 WCF 服務合約 (介面) 和輸入作業的協助程式碼。

  • SqlAdapterBindingService.cs。 此檔案包含實作 SqlAdapterBindingInterface.cs 中定義之介面的類別。 您可以實作商務邏輯來處理輸入作業所傳回的記錄。

  • app.config。此檔案包含系結組態、端點行為和服務端點組態,以您在設定 [新增配接器服務參考外掛程式] 的系結和連線時所做的選項為基礎。

    重要

    使用 [新增配接器服務參考外掛程式] 時,如果您未為字串類型的系結屬性指定值,且其預設值為 null,則該系結屬性將無法在 app.config 檔案中使用。 如有必要,您必須在 app.config 檔案中手動新增系結屬性及其值。

使用 svcutil.exe 產生 WCF 用戶端類別

您可以使用 svcutil.exe 為您的應用程式產生 WCF 用戶端類別。 您必須將 svcutil.exe 設定為將它與 SQL 配接器搭配使用。

Svcutil.exe 會在輸出檔中產生 WCF 用戶端類別,其預設檔案名為 output.cs。 您必須在 Visual Studio 專案中手動包含此檔案。 如需 svcutil.exe 的詳細資訊,請參閱 ServiceModel 中繼資料公用程式工具 (Svcutil.exe)

另請參閱

使用 WCF 服務模型開發 SQL 應用程式