在 .NET 專案中取用 WCF LOB 配接器 SDK 配接器
若要從 Visual Studio 使用 WCF LOB 配接器 SDK 建置的配接器,您必須將服務參考新增至專案。 您可以這麼做來達到此目的:
使用新增配接器服務參考 Visual Studio 外掛程式,此外掛程式會安裝為 WCF LOB 配接器 SDK 的一部分。
使用 svcutil.exe (ServiceModel 中繼資料公用程式) ,此公用程式會安裝為 Windows SDK 的一部分。
使用新增配接器服務參考外掛程式新增服務參考
[新增配接器服務參考外掛程式] 可用來流覽和搜尋中繼資料,以及使用選取的作業和類型產生 .NET CLR Proxy 類別。
在 Visual Studio 中開啟 .NET 應用程式。
在 Visual Studio 中,以滑鼠右鍵按一下 [專案 ] 功能表,然後按一下 [ 新增配接器服務參考]。
注意
BizTalk Server專案不會出現此選項。
在 [新增配接器服務參考外掛程式] 畫面的 [ 選取系結 ] 下拉式清單中,選取配接器系結。
若要設定所選配接器系結的連線 URI,並提供任何認證、URI 屬性和系結屬性,請按一下 [ 設定]。 實際需求會根據選取的配接器系結而有所不同。
當您設定 URI 時,請按一下 [ 確定]。
按一下 [連線]。 如果連線 URI 有效且用戶端認證 (接受任何) ,則 [ 類別] 窗格應該填入配接器所提供的類別和作業。
如果配接器支援搜尋,搜尋欄位將會作用中。 否則,您可以按一下 [ 類別 ] 窗格中的節點,依合約類型、探索類型和作業進行篩選。
針對進階 Proxy 產生選項,按一下 [ 進階]。 選項包含:
選項 對等 svcutil.exe 選項 Description 產生非同步方法 /async 同時產生同步與非同步方法簽章。
如果未選取預設 () :只會產生同步方法簽章。產生訊息合約 /messageContract 產生訊息合約類型。 將類型設為內部 /internal 產生標示為內部的類別。
如果未選取預設 () :產生公用類別。啟用資料系結 /enableDataBinding 在所有資料合約類型上實作 System.ComponentModel.INotifyPropertyChanged 介面,以啟用資料系結。 將非資料類型匯入為 IXmlSerializable /importXmlTypes 設定資料合約序列化程式,將非資料合約類型匯入為 IXmlSerializable 類型。 產生通道介面 產生通道介面。 標記類別可序列化 選取是否要使用序列化程式產生資料類型。 不產生 app.config /noConfig 不會產生應用程式組態檔。 serializer
Auto/serializer:Auto 自動選取序列化和還原序列化的序列化程式。 serializer
DataContract 序列化程式/serializer:DataContractSerializer 產生使用資料合約序列化程式進行序列化和取消序列化的資料類型 serializer
XmlSerializer/serializer:XmlSerializer 產生使用 XmlSerializer 進行序列化和還原序列化的資料類型。 若要產生 Proxy 成品,請按一下 [ 確定]。 成品數目會根據合約類型而有所不同。
合約類型 成品 Description 傳出 CLR WCF Proxy 包含合約和服務實作。 傳出 App.config 包含 < 系統的端點 > 和 < 綁定 > 項 < 。ServiceModel >< 用戶端 > 。 連入 CLR WCF 服務介面 包含合約。 連入 CLR WCF 服務實作 衍生自合約的存根實作。 連入 App.config 包含 < 系統的端點 > 、 < 系結 > 和 < 行為 > 專案 < 。ServiceModel >< 服務 > 。 您現在可以在應用程式中使用 Proxy。
使用 svcutil.exe 新增服務參考
Svcutil.exe 是命令列公用程式,可用來擷取中繼資料並產生 .NET CLR Proxy 類別,然後新增至 Visual Studio 專案。 如需 svcutil.exe 的詳細資訊,請參閱 ServiceModel 中繼資料公用程式工具 (Svcutil.exe) 。
從裝載于 IIS 的配接器產生 Proxy 類別
在命令提示字元中,輸入 svcutil.exe 「 <http://localhost/adapter/AdapterService.svc?wsdl 」 > /config:app.config。以裝載介面卡的正確路徑取代 HTTP 路徑。 這會建立包含 .NET CLR Proxy 和 output.config 的 .cs 檔案,其中包含 system.serviceModel > 的 << 系結 > 和用戶端 < 端點 > 。
注意
如果您的配接器包含許多作業,您可以使用 'op=' 的查詢字串來限制傳回的作業,後面接著您感興趣的作業名稱。 例如:
svcutil.exe “http://localhost/adapter/AdapterService.svc?wsdl&op=Echo/EchoString&op=Echo/EchoArray”
只針對 EchoString 和 EchoArray 作業產生 Proxy 程式碼。在 Visual Studio 中,開啟您的專案。
在方案總管中,以滑鼠右鍵按一下專案,指向 [新增],然後按一下 [新增專案]。 在 [ 新增現有專案 ] 對話方塊中,選取先前建立的 .cs 和 app.config 檔案。 按一下 [新增]。
在 [方案總管] 中,以滑鼠右鍵按一下 [參考],然後按一下 [新增參考]。 在 [.NET] 索引標籤上,選取 [System.ServiceModel],然後按一下 [ 確定]。 您現在可以在應用程式中使用 Proxy。