共用方式為


在 .NET 專案中取用 WCF LOB 配接器 SDK 配接器

若要從 Visual Studio 使用 WCF LOB 配接器 SDK 建置的配接器,您必須將服務參考新增至專案。 您可以這麼做來達到此目的:

  • 使用新增配接器服務參考 Visual Studio 外掛程式,此外掛程式會安裝為 WCF LOB 配接器 SDK 的一部分。

  • 使用 svcutil.exe (ServiceModel 中繼資料公用程式) ,此公用程式會安裝為 Windows SDK 的一部分。

使用新增配接器服務參考外掛程式新增服務參考

[新增配接器服務參考外掛程式] 可用來流覽和搜尋中繼資料,以及使用選取的作業和類型產生 .NET CLR Proxy 類別。

  1. 在 Visual Studio 中開啟 .NET 應用程式。

  2. 在 Visual Studio 中,以滑鼠右鍵按一下 [專案 ] 功能表,然後按一下 [ 新增配接器服務參考]。

    注意

    BizTalk Server專案不會出現此選項。

  3. 在 [新增配接器服務參考外掛程式] 畫面的 [ 選取系結 ] 下拉式清單中,選取配接器系結。

  4. 若要設定所選配接器系結的連線 URI,並提供任何認證、URI 屬性和系結屬性,請按一下 [ 設定]。 實際需求會根據選取的配接器系結而有所不同。

  5. 當您設定 URI 時,請按一下 [ 確定]。

  6. 按一下 [連線]。 如果連線 URI 有效且用戶端認證 (接受任何) ,則 [ 類別] 窗格應該填入配接器所提供的類別和作業。

  7. 如果配接器支援搜尋,搜尋欄位將會作用中。 否則,您可以按一下 [ 類別 ] 窗格中的節點,依合約類型、探索類型和作業進行篩選。

  8. 針對進階 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 進行序列化和還原序列化的資料類型。
  9. 若要產生 Proxy 成品,請按一下 [ 確定]。 成品數目會根據合約類型而有所不同。

    合約類型 成品 Description
    傳出 CLR WCF Proxy 包含合約和服務實作。
    傳出 App.config 包含 < 系統的端點 > 和 < 綁定 > 項 < 。ServiceModel >< 用戶端 > 。
    連入 CLR WCF 服務介面 包含合約。
    連入 CLR WCF 服務實作 衍生自合約的存根實作。
    連入 App.config 包含 < 系統的端點 > 、 < 系結 > 和 < 行為 > 專案 < 。ServiceModel >< 服務 > 。
  10. 您現在可以在應用程式中使用 Proxy。

使用 svcutil.exe 新增服務參考

Svcutil.exe 是命令列公用程式,可用來擷取中繼資料並產生 .NET CLR Proxy 類別,然後新增至 Visual Studio 專案。 如需 svcutil.exe 的詳細資訊,請參閱 ServiceModel 中繼資料公用程式工具 (Svcutil.exe)

從裝載于 IIS 的配接器產生 Proxy 類別

  1. 在命令提示字元中,輸入 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 程式碼。

  2. 在 Visual Studio 中,開啟您的專案。

    1. 方案總管中,以滑鼠右鍵按一下專案,指向 [新增],然後按一下 [新增專案]。 在 [ 新增現有專案 ] 對話方塊中,選取先前建立的 .cs 和 app.config 檔案。 按一下 [新增]。

    2. 在 [方案總管] 中,以滑鼠右鍵按一下 [參考],然後按一下 [新增參考]。 在 [.NET] 索引標籤上,選取 [System.ServiceModel],然後按一下 [ 確定]。 您現在可以在應用程式中使用 Proxy。

另請參閱

教學課程 1:開發 Echo 配接器
使用 WCF LOB 配接器 SDK 建立的配接器