共用方式為


新增、更新或移除 WCF 資料服務參考

針對 .NET Framework 專案,服務參考可讓專案存取一或多個 WCF 資料服務。 使用 [新增服務參考] 對話方塊,在目前解決方案、本機、區域網路或網際網路上搜尋 WCF 資料服務。

針對 .NET Core 專案,您可以使用 [方案總管] 中的 [已連線的服務] 節點來存取 Microsoft WCF Web 服務參考提供者,這可讓您管理 Windows Communication Foundation (WCF) 資料服務參考。

注意

在本文的某些 Visual Studio 使用者介面項目中,您的電腦可能會顯示不同的名稱或位置。 您使用的可能是不同版本的 Visual Studio 或不同的環境設定。 如需詳細資訊,請參閱將 IDE 個人化

必要條件

WCF 工具未與 .NET 工作負載一起安裝;使用 Visual Studio 安裝程式來修改您的安裝。 在安裝程式中,選擇 [個別元件] 下的 [Windows Communication Foundation]。 請參閱修改 Visual Studio

新增 WCF 服務參考

若要新增外部服務的參考 (.NET Framework 專案)

  1. 在 [方案總管] 中,以滑鼠右鍵按一下要新增服務的專案名稱,然後按一下 [新增服務參考]

    [新增服務參考] 對話方塊隨即出現。

  2. 在 [位址] 方塊中,輸入服務的 URL,然後按一下 [移至] 以搜尋服務。 如果服務會實作使用者名稱和密碼安全性,則您可能會看見使用者名稱和密碼的提示。 您也可以在自己的解決方案中選擇服務。 選擇 [探索] 按鈕,然後選擇 [解決方案中的服務]

    注意

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

    您也可以從 [位址] 清單中選取 URL,可儲存找到有效服務中繼資料的前 15 個 URL。

    執行搜尋時,會顯示進度列。 您可以隨時按一下 [停止] 來停止搜尋。

  3. 在 [服務] 清單中,展開要使用服務的節點,然後選取實體集。

  4. 在 [命名空間] 方塊中,輸入要針對參考使用的命名空間。

  5. 按一下 [確定],將參考新增至專案中。

    即會產生服務用戶端 (Proxy),並將說明服務的中繼資料新增至 app.config 檔案中。

若要新增外部服務 (.NET Core 專案,包括 .NET 5 和更新版本) 的參考

  1. 在 [方案總管] 中,按兩下或點選 [已連線的服務] 節點。

    [設定服務] 索引標籤隨即開啟。

  2. 選擇 Microsoft WCF Web Service Reference Provider

    [設定 WCF Web 服務參考] 對話方塊隨即出現。

    螢幕擷取畫面,其中顯示了「WCF Web 服務提供者」對話框

  3. 在 [URI] 方塊中,輸入服務的 URL,然後按一下 [移至] 以搜尋服務。 如果服務會實作使用者名稱和密碼安全性,則您可能會看見使用者名稱和密碼的提示。

    注意

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

    您也可以從 [URI] 清單中選取 URL,可儲存找到有效服務中繼資料的前 15 個 URL。

    執行搜尋時,會顯示進度列。 您可以隨時按一下 [停止] 來停止搜尋。

  4. 在 [服務] 清單中,展開要使用服務的節點,然後選取實體集。

  5. 在 [命名空間] 方塊中,輸入要針對參考使用的命名空間。

  6. 按一下 [完成] 以新增專案的參考。

    即會產生服務用戶端 (Proxy),並將說明服務的中繼資料新增至 app.config 檔案中。

若要在目前解決方案 (.NET Framework 專案) 中新增服務的參考

  1. 在 [方案總管] 中,以滑鼠右鍵按一下要新增服務的專案名稱,然後按一下 [新增服務參考]

    [新增服務參考] 對話方塊隨即出現。

  2. 按一下 [探索]

    目前解決方案中的所有服務 (WCF Data Services 和 WCF 服務) 都會新增至 [服務] 清單。

  3. 在 [服務] 清單中,展開要使用服務的節點,然後選取實體集。

  4. 在 [命名空間] 方塊中,輸入要針對參考使用的命名空間。

  5. 按一下 [確定],將參考新增至專案中。

    服務用戶端 (proxy) 會產生 app.config 檔案,而描述服務的中繼資料會新增至該檔案。

若要在目前解決方案中新增服務的參考 (.NET Core 專案)

  1. 在 [方案總管] 中,按兩下或點選 [已連線的服務] 節點。

    [設定服務] 索引標籤隨即開啟。

  2. 選擇 Microsoft WCF Web Service Reference Provider

    [設定 WCF Web 服務參考] 對話方塊隨即出現。

  3. 按一下 [探索]

    目前解決方案中的所有服務 (WCF Data Services 和 WCF 服務) 都會新增至 [服務] 清單。

  4. 在 [服務] 清單中,展開要使用服務的節點,然後選取實體集。

  5. 在 [命名空間] 方塊中,輸入要針對參考使用的命名空間。

  6. 按一下 [完成] 以新增專案的參考。

    服務用戶端 (proxy) 會產生 app.config 檔案,而描述服務的中繼資料會新增至該檔案。

更新服務參考

WCF 資料服務的實體資料模型有時會變更。 發生這種情況時,您必須更新服務參考。

若要更新服務參考

  • 在 [方案總管] 中,以滑鼠右鍵按一下服務參考,然後按一下 [更新服務參考]

    當從參考的原始位置進行更新時,會顯示進度對話方塊,並重新產生服務用戶端,以反映中繼資料中的任何變更。

若為 .NET Core 專案,請使用 dotnet-svcutil 工具。 請參閱 dotnet-svcutil 以瞭解安裝與指示。

若為 .NET Framework 專案:

  • 在 [方案總管] 中,展開 [已連線的服務] 節點,以滑鼠右鍵按一下服務參考,然後按一下 [更新服務參考]

    當從參考的原始位置進行更新時,會顯示進度對話方塊,並重新產生服務用戶端,以反映中繼資料中的任何變更。

移除服務參考

如果不再使用服務參考,您可以從解決方案中將其移除。

若要移除服務參考

  • 在 [方案總管] 中,以滑鼠右鍵按一下服務參考,然後按一下 [刪除]

    將會從解決方案中移除服務用戶端,而描述服務的中繼資料則會從 app.config 檔案中移除。

    注意

    任何參考服務參考的程式碼都必須以手動方式移除。