產生 Oracle 資料庫解決方案成品的 WCF 用戶端或 WCF 服務合約

發行項
07/21/2023

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

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

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

產生 WCF 用戶端類別

在 Visual Studio 方案總管中，以滑鼠右鍵按一下您的專案，然後按一下 [新增配接器服務參考]。
開啟 [ 新增配接器服務參考 ] 對話方塊之後，請遵循在 Visual Studio 中擷取 Oracle 作業的中繼資料中的步驟，連線到 Oracle 資料庫並流覽和搜尋作業。若要為您所選取的作業建立 WCF 用戶端類別，請確定已從 [選取合約類型] 下拉式清單中選取 [用戶端 (輸出) 作業]， (這是預設) 。
選取您想要鎖定的所有作業之後，按一下 [ 確定 ] 以產生 WCF 用戶端類別。

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

OracleDBBindingClient.cs。此檔案包含您所選取之作業的產生的 WCF 用戶端類別和協助程式程式碼。
App.config。此檔案包含系結組態和用戶端端點組態。這些設定是以您在設定 [新增配接器服務參考外掛程式] 的系結和連線時所做的選擇為基礎。

重要

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

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

配接器會公開輸入作業，讓 Oracle 資料庫將訊息傳送至配接器用戶端。針對這類作業，您必須產生 WCF 服務合約。例如，配接器會公開輸入 POLLINGSTMT 作業來輪詢 Oracle 資料庫。 Oracle Database 配接器會執行 PollingStatement 系結屬性所指定的查詢，並將結果集傳送至 POLLINGSTMT 訊息中的取用應用程式。在此案例中，取用的應用程式會作為服務，而 Oracle 資料庫配接器會作為用戶端。因此，您必須實作可從配接器接收 POLLINGSTMT 作業的 WCF 服務。若要這樣做，您可以使用 [新增配接器服務參考外掛程式] 來產生 .NET 介面，代表轉接器針對 POLLINGSTMT 作業呈現的服務合約。這個 .NET 介面也稱為 WCF 服務合約。接著，您可以實作此介面來建立 WCF 服務，以用來接收 POLLINGSTMT 作業。

本節提供如何使用新增配接器服務參考外掛程式產生 WCF 服務合約的相關資訊，以用於配接器所公開的輸入作業。

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

在 Visual Studio 方案總管中，以滑鼠右鍵按一下您的專案，然後按一下 [新增配接器服務參考]。
開啟 [ 新增配接器服務參考 ] 對話方塊之後，請遵循在 Visual Studio 中擷取 Oracle 作業的中繼資料中的步驟，連線到 Oracle 資料庫。當您連線到 Oracle 資料庫以進行輸入作業時，可能會想要設定數個系結屬性和 URI 屬性。例如，針對 (POLLINGSTMT) 的輸入輪詢作業，您必須在設定與 Oracle 資料庫的連線時指定 PollingStatement 系結屬性。 Oracle Database 配接器會使用此屬性中指定的 SQL SELECT 語句來產生類別，代表 POLLINGSTMT 作業所傳回的結果集。
連線到 Oracle 資料庫之後，請從 [選取合約類型] 下拉式清單中選取 [服務 (輸入作業) ]。
在 [ 選取類別] 方塊中，按一下根節點 (/) ，然後流覽至您想要產生服務合約的作業。例如，針對輪詢作業，請從 [可用的類別和作業] 方塊中選取POLLINGSTMT，然後按一下 [新增]。
若要產生 POLLINGSTMT 作業的 WCF 服務合約，請按一下 [ 確定]。

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

OracleDBBindingInterface.cs。此檔案包含產生的 WCF 服務合約 (介面) 和 POLLINGSTMT 作業的協助程式碼。
OracleDBBindingService.cs。此檔案包含實作 OracleDBBindingInterface.cs 中定義之介面的類別。您可以實作商務邏輯，以處理此類別中 POLLINGSTMT 方法中輪詢查詢所傳回的記錄。
App.config。此檔案包含系結組態、端點行為和服務端點組態，以您在設定 [新增配接器服務參考外掛程式] 的系結和連線時所做的選項為基礎。

重要

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

使用 svcutil.exe 產生 WCF 用戶端類別或 WCF 服務合約

您可以使用 svcutil.exe 為您的應用程式產生 WCF 用戶端類別或 WCF 服務介面。您必須將 svcutil.exe 設定為將它與 Oracle 資料庫配接器搭配使用。如需設定及搭配 Oracle 資料庫配接器使用 svcutil.exe 的詳細資訊，請參閱搭配 BizTalk Adapter for Oracle Database 使用 ServiceModel 中繼資料公用程式工具。

Svcutil.exe 會在輸出檔中產生 WCF 用戶端類別或 WCF 服務合約。預設檔案名為 output.cs。您必須在 Visual Studio 專案中手動包含此檔案。

另請參閱

使用 WCF 服務模型開發 Oracle 資料庫應用程式
 使用 WCF 服務模型在 SQL 中執行基本插入、更新、刪除和選取作業

共用方式為