使用 WCF Web Service Reference Provider 工具

發行項
02/27/2024

多年來，許多 Visual Studio 開發人員都享受新增服務參考工具在其 .NET Framework 專案需要存取 Web 服務時所提供的生產力。

WCF Web Service Reference 工具為 Visual Studio 連線服務擴充功能，可讓您將 .NET 5+、.NET Core 或 ASP.NET Core 專案連線至 Web 服務。當中提供的體驗類似加入服務參考功能 (僅適用於 .NET Framework 專案)。 WCF Web Service Reference 工具可從目前方案中的 Web 服務、網路位置或 WSDL 檔案擷取中繼資料，且能產生來源檔案，其中包含的 Windows Communication Foundation (WCF) 用戶端 Proxy 程式碼可用於讓 .NET 存取 Web 服務。

重要

您只應該參考來自信任來源的服務。新增不信任來源的參考可能會危及安全性。

必要條件

Visual Studio 2017 版本 15.5 或更新版本

本文中的螢幕擷取畫面皆來自 Visual Studio 2022。

如何使用延伸模組

注意

WCF Web Service Reference 工具僅適用於 C# .NET Core 和 .NET Standard 專案，包含 ASP.NET Core Web 應用程式。

使用 ASP.NET Core Web 應用程式 專案範本作為範例，本文會引導您完成將 WCF 服務參考新增至專案。

在方案總管中，按兩下專案的 [已連線的服務] 節點。 (針對 .NET Core 或 .NET Standard 專案，以滑鼠右鍵按一下專案，並選取 [新增]>[連線服務]。)

[已連線的服務] 頁面隨即顯示 (如下圖所示)：
在 [已連線的服務] 頁面上，選取 [加入服務參考]。

[加入服務參考] 頁面隨即開啟。
選取 [WCF Web 服務]，然後選擇 [下一步]。

隨即顯示 [新增 WCF Web 服務參考] 精靈。
選取服務。

a. 有數個可用的服務搜尋選項：
- 若要搜尋目前方案中所定義的服務，請按一下 [探索] 按鈕。
- 若要搜尋所指定位址裝載的服務，請在 [位址] 方塊中輸入服務 URL，然後按一下 [執行] 按鈕。
- 若要選取包含 Web 服務中繼資料資訊的 WSDL 檔案，請按一下 [瀏覽] 按鈕。
b. 在 [服務] 方塊中，從搜尋結果清單中選取服務。如有需要，請在對應的 [命名空間] 文字方塊中輸入已產生程式碼的命名空間。

c. 按一下 [下一步] 按鈕，以指定資料類型選項或用戶端選項。或者，按一下 [完成] 按鈕以使用預設選項。
[資料類型選項] 頁面可簡化產生的服務參考組態設定：

注意

其中一個專案的參考組件內定義服務參考程式碼產生所需的資料類型時，[重複使用參考組件中的類型] 核取方塊選項十分有用。請務必重複使用這些現有資料類型，避免造成編譯時期類型衝突或執行階段問題。

根據專案相依性數目和其他系統效能因素，在載入類型資訊時可能會延遲。除非取消核取 [重複使用參考組件中的類型] 核取方塊，否則會在載入期間停用 [完成] 按鈕。
完成時，請按一下 [完成]。