針對 .NET Framework 專案, 服務參考 可讓專案存取一或多個 WCF 數據服務。 使用 [ 新增服務參考 ] 對話框,在目前解決方案、本機、局域網路或因特網上搜尋 WCF 數據服務。
針對 .NET Core 專案,您可以使用 [方案總管] 中的 [已連線服務] 節點來存取 Microsoft WCF Web 服務參考提供者,這可讓您管理 Windows Communication Foundation (WCF) 數據服務參考。
備註
本文中的指示說明 Visual Studio 中可用的互動式開發體驗 (IDE) 最新版本。 您的電腦可能會顯示某些使用者介面元素的不同名稱或位置。 您可能使用不同的 Visual Studio 版本或不同的環境設定。 如需詳細資訊,請參閱 個人化 IDE。
先決條件
WCF 工具未與 .NET 工作負載一起安裝;使用 Visual Studio 安裝程式來修改您的安裝。 在安裝程式中,選擇 [個別元件] 下的 [Windows Communication Foundation ]。 請參閱 修改 Visual Studio。
新增 WCF 服務參考
若要新增外部服務的參考 (.NET Framework 專案)
在 [方案總管] 中,以滑鼠右鍵按下您要新增服務的專案名稱,然後選取 [ 新增服務參考]。
[ 新增服務參考 ] 對話框隨即出現。
在 [ 位址 ] 方塊中,輸入服務的 URL,然後選取 [移至 ] 以搜尋服務。 如果服務實作使用者名稱和密碼安全性,系統可能會提示您輸入使用者名稱和密碼。 您也可以在自己的解決方案中選擇服務。 選擇 [ 探索] 按鈕,然後選擇 [解決方案中的服務]。
備註
您應該只參考來自受信任來源的服務。 從不受信任的來源新增參考可能會危害安全性。
您也可以從 [ 位址 ] 列表中選取 URL,以儲存找到有效服務元數據的前 15 個 URL。
執行搜尋時會顯示進度列。 您可以按下 [ 停止],隨時停止搜尋。
在 [ 服務 ] 清單中,展開您想要使用之服務的節點,然後選取實體集。
在 [ 命名空間] 方塊中,輸入您要用於參考的命名空間。
按兩下 [確定 ] 以新增項目的參考。
會產生服務用戶端(proxy),而描述服務的元數據會新增至 app.config 檔案。
若要新增外部服務的參考(.NET Core 專案,包括 .NET 5 和更新版本)
在 [方案總管] 中,按兩下或點選 [ 已連線的服務 ] 節點。
[ 設定服務] 索引 標籤隨即開啟。
選擇 [Microsoft WCF Web 服務參考提供者]。
[ 設定 WCF Web 服務參考 ] 對話框隨即出現。
在 [URI] 方塊中,輸入服務的 URL,然後選取 [移至 ] 以搜尋服務。 如果服務實作使用者名稱和密碼安全性,系統可能會提示您輸入使用者名稱和密碼。
備註
您應該只參考來自受信任來源的服務。 從不受信任的來源新增參考可能會危害安全性。
您也可以從 URI 清單中選取 URL,以儲存找到有效服務元數據的前 15 個 URL。
執行搜尋時會顯示進度列。 您可以按下 [ 停止],隨時停止搜尋。
在 [ 服務 ] 清單中,展開您想要使用之服務的節點,然後選取實體集。
在 [ 命名空間] 方塊中,輸入您要用於參考的命名空間。
按兩下 [完成 ] 以新增項目的參考。
會產生服務用戶端(proxy),而描述服務的元數據會新增至 app.config 檔案。
若要在目前解決方案中新增服務的參考 (.NET Framework 專案)
在 [方案總管] 中,以滑鼠右鍵按下您要新增服務的專案名稱,然後選取 [ 新增服務參考]。
[ 新增服務參考 ] 對話框隨即出現。
按兩下 [探索]。
目前解決方案中的所有服務(WCF Data Services 和 WCF 服務)都會新增至 [服務 ] 列表。
在 [ 服務 ] 清單中,展開您想要使用之服務的節點,然後選取實體集。
在 [ 命名空間] 方塊中,輸入您要用於參考的命名空間。
按兩下 [確定 ] 以新增項目的參考。
服務用戶端 (proxy) 會產生 ,而描述服務的元數據會新增至 app.config 檔案。
若要在目前解決方案中新增服務的參考 (.NET Core 專案)
在 [方案總管] 中,按兩下或點選 [ 已連線的服務 ] 節點。
[ 設定服務] 索引 標籤隨即開啟。
選擇 [Microsoft WCF Web 服務參考提供者]。
[ 設定 WCF Web 服務參考 ] 對話框隨即出現。
按兩下 [探索]。
目前解決方案中的所有服務(WCF Data Services 和 WCF 服務)都會新增至 [服務 ] 列表。
在 [ 服務 ] 清單中,展開您想要使用之服務的節點,然後選取實體集。
在 [ 命名空間] 方塊中,輸入您要用於參考的命名空間。
按兩下 [完成 ] 以新增項目的參考。
服務用戶端 (proxy) 會產生 ,而描述服務的元數據會新增至 app.config 檔案。
更新服務參考
WCF 數據服務的實體數據模型有時會變更。 發生這種情況時,您必須更新服務參考。
更新服務參考
在 [方案總管] 中,以滑鼠右鍵按兩下服務參考,然後選取 [更新服務參考]。
當參考從原始位置更新時,會顯示進度對話框,並重新產生服務用戶端以反映元數據中的任何變更。
針對 .NET Core 專案,請使用 dotnet-svcutil 工具。 如需安裝和指示,請參閱 dotnet-svcutil 。
針對 .NET Framework 專案:
在 [方案總管] 中,展開 [ 已連線的服務 ] 節點,以滑鼠右鍵按兩下服務參考,然後選取 [ 更新服務參考]。
當參考從原始位置更新時,會顯示進度對話框,並重新產生服務用戶端以反映元數據中的任何變更。
拿掉服務參考
如果不再使用服務參考,您可以從解決方案中移除它。
拿掉服務參考
在 [方案總管] 中,以滑鼠右鍵按兩下服務參考,然後選取 [ 刪除]。
服務用戶端將會從解決方案中移除,而描述服務的元數據將會從 app.config 檔案中移除。
備註
任何參考服務參考的程式代碼都必須手動移除。