使用 Visual Studio 連線服務新增 Azure Cache for Redis

發行項
03/09/2025

使用 Visual Studio，您可以使用 Connected Services 功能，將下列任一項連線至 Azure Cache for Redis：

.NET Framework 控制台應用程式
ASP.NET 模型-View-Controller （MVC）（.NET Framework）
ASP.NET Core
.NET Core （包括控制台應用程式、WPF、Windows Forms、類別庫）
.NET Core Worker 角色
Azure Functions
通用 Windows 平台應用程式
科爾多瓦

線上的服務功能會將所有必要的參考和連線程式代碼新增至專案，並適當地修改組態檔。

先決條件

已安裝 Azure 工作負載的 Visual Studio。
一個屬於支援類型的專案
Azure 帳戶。如果您沒有 Azure 帳戶，請為 Visual Studio 訂閱者啟用 Azure 權益，或註冊免費試用。

使用 Connected Services 連線到 Azure Cache for Redis

在 Visual Studio 中開啟您的專案。
在 [方案總管]中，以滑鼠右鍵按兩下 [連線服務] 節點，然後從操作功能表中選取 [[新增已連線的服務]。

如果您沒有看到 [連線服務] 節點，請選擇 [專案>連線服務]>[新增]。
在 [連線服務] 索引標籤中，選取 [服務相依性的 + 圖示。
在 [[新增相依性] 頁面中，選取 [Azure Cache for Redis]。

如果您尚未登入，請登入您的 Azure 帳戶。如果您沒有 Azure 帳戶，您可以註冊免費試用。
在[設定 Azure Cache for Redis] 畫面中，選取現有的 Azure Cache for Redis，然後選取 [下一步] 。

如果您需要建立新的元件，請移至下一個步驟。否則，請跳至步驟 7。
若要建立 Azure Cache for Redis：
1. 在畫面底部選取 建立新的 Azure Redis 快取。
2. 填寫 Azure Cache for Redis：建立新的 畫面，然後選取建立。
3. 當 [設定 Azure Cache for Redis] 畫面顯示時，新快取會出現在清單中。選取清單中的新資料庫，然後選取 [下一步]。
輸入連接字串名稱，或選擇預設值，然後選擇您要將連接字串儲存在本機秘密檔案中，還是 Azure Key Vault中。
變更摘要 畫面顯示如果您完成這個過程，將會對您的專案進行的所有修改。如果變更看起來沒問題，請選擇完成。
[服務相依性] 區段會出現在 [已連線服務] 索引標籤下。

注意

對於 .NET Framework 專案，連線服務 UI 稍有不同。若要查看差異，請與此頁面的 Visual Studio 2019 版本進行比較。

在 Visual Studio 中開啟您的專案。
在 [方案總管]中，以滑鼠右鍵按兩下 [連線服務] 節點，然後從操作功能表中選取 [新增]，以開啟可用服務的功能表。

如果您沒有看到 [連線服務] 節點，請選擇 [專案>連線服務]>[新增]。
選擇 Azure Cache for Redis。 連線到相依性 頁面隨即出現。您應該會看到兩個選項：一個是用於本機模擬器的本地容器上的 Redis 快取，另一個選項是用於連線到線上 Azure Cache for Redis 服務。您可以從本機模擬器開始降低成本並簡化早期開發。您可以稍後重複這些步驟並選擇另一個選項，以移轉至實時服務。

如果您選擇本機的 Azure Cache for Redis 請點選下一步進入在容器上連線至 Redis 快取的畫面。

指定 容器名稱、容器映像檔以及埠對應，或接受預設值，然後按一下 [下一步] 以查看 [變更摘要] 畫面，顯示會對您的專案進行何種變更。 NuGet 套件參考會新增至您的專案，而本機模擬器的連線程式代碼會新增至您的專案。

如果您想要連線到 Azure 服務，請繼續進行下一個步驟，或如果您尚未登入，請先登入您的 Azure 帳戶，再繼續進行。如果您沒有 Azure 帳戶，您可以註冊免費試用。
若要使用即時服務，請選取 [Azure Cache for Redis。

如果您尚未登入，請登入您的 Azure 帳戶。如果您沒有 Azure 帳戶，您可以註冊免費試用。
在[設定 Azure Cache for Redis] 畫面中，選取現有的 Azure Cache for Redis，然後選取 [下一步] 。

如果您需要建立新的元件，請移至下一個步驟。否則，請跳至步驟 7。
若要建立 Azure Cache for Redis：
1. 選取 [在畫面底部建立新的 Azure Redis 快取。
2. 填寫 Azure Cache for Redis：建立新的 畫面，然後選取 [建立] [建立]。
3. 當 [設定 Azure Cache for Redis] 畫面顯示時，新快取會出現在清單中。選取清單中的新資料庫，然後選取 [下一步]。
輸入連線設定名稱，或接受預設值。

注意

為了改善安全性，在 Visual Studio 17.12 和更新版本中，此步驟會建立連線設定名稱;舊版會建立連接字串。儲存在本機文件系統中的連接字串可能會導致安全性風險，如果意外公開。
按兩下 [[其他設定]，然後選擇您要將連線設定儲存在本機秘密檔案中，還是 Azure Key Vault。
變更摘要 畫面顯示如果您完成這個過程，將會對您的專案進行的所有修改。如果變更看起來沒問題，請選擇完成。
在 [方案總管] 中，按兩下 [連線服務] 節點，以開啟 [連線服務] 索引標籤。連線會出現在 [服務相依] 區段底下：

如果您按下所新增相依性旁的三個點，您可以看到各種選項，例如 Connect 重新開啟精靈並變更連線。您也可以按下視窗右上方的三個點，檢視啟動本機相依性、變更設定等選項。