快速入門：使用 Azure Redis 搭配 ASP.NET Web 應用程式

適用於: ✅ Azure Cache for Redis

在本快速入門中，您會使用 Visual Studio 2019 建立 ASP.NET Web 應用程式，並連線至 Azure Cache for Redis 以儲存資料和從快取擷取資料。接著，您會將應用程式部署到 Azure App Service。

複製 GitHub 上的存放庫 https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet。

先決條件

Azure 訂用帳戶 - 建立免費帳戶
Visual Studio 2019，包含 ASP.NET 與 Web 開發和 Azure 開發工作負載。
.NET Framework 4 或更新版本，這是 StackExchange.Redis 用戶端的必要項目。

建立 Azure 受控 Redis 實例

若要建立 Azure 受控 Redis 實例，請登入 Azure 入口網站，然後選取 [ 建立資源]。
在「建立資源」頁面中的搜索框中輸入Azure Managed Redis。
選擇 Azure Managed Redis 磁貼並選擇 「建立」。

在 「建立 Azure Managed Redis 實例 」面板中，在 「基礎 」標籤中設定新快取的設定。

設定	選擇值	說明
訂閱	下拉並選取您的訂用帳戶。	這個新的 Azure Managed Redis 執行個體建立所在的訂用帳戶。
資源群組	下拉並選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
名稱	輸入區域中唯一的名稱。	當快取名稱與快取的區域名稱合併 (只包含數字、字母或連字號) 時，必須為介於 1 到 63 個字元之間的字串。 (如果快取名稱長度小於 45 個字元，則應該適用於所有目前可用的區域。) 名稱必須以數字或字母開頭和結尾，且不能包含連續連字號。快取執行個體的主機名稱為 `\<DNS name\>.\<Azure region\>.redis.azure.net`。
區域	下拉並選取位置。	Azure Managed Redis 可在選取的 Azure 區域中使用。
數據層	選取內存以提供高效能，或選取效能較低的Flash快取	記憶體內部層包括平衡、記憶體優化和計算優化。使用 Flash 層來使用記憶體內部（RAM）和磁碟上的（SSD）資料記憶體。
快取大小	下拉選單並選取大小。	快取大小取決於階層。最小的尺寸是平衡等級。記憶體內部層大小最大的是記憶體優化層。
效能	打開下拉選單並選取效能偏好。	效能取決於 vCPU 的數目。 vCPU 數目會隨著層級而有所不同。計算最佳化具有最多的 vCPU。

如需選擇正確效能層級的指引，請參閱選擇正確的層級。

這很重要

所有使用超過 235 GB 儲存空間的記憶體內層級皆在公開預覽中，包括記憶體優化 M350 及以上版本;平衡 B350 及以上;以及 Compute Optimized X350 及以上版本。所有這些層級和更高層級都處於公開預覽狀態。

所有 Flash 優化層都處於公開預覽狀態。

選擇 「下一頁：網路」 ，並選擇 「停用公共存取並使用私人存取 」或 「啟用所有網路的公開存取」。
選取 [下一步：主動式異地複寫]。若要使用主動式異地復寫功能，必須在布建期間啟用此功能。沒有作用中異地複寫的快取無法在稍後新增或加入作用中異地複寫群組。如需詳細資訊，請參閱設定 Azure Managed Redis 執行個體的作用中異地複寫。
選取 [ 下一步：進階 ] 索引標籤。

設定您想要新增至實例的任何 Redis 模組。

設定 叢集原則：
- 使用 Enterprise 以使用 RedisSearch 或其他模組
- 針對叢集快取使用 OSS 。
- 針對非叢集快取使用非叢集式（預覽版）。
如需選擇叢集原則的詳細資訊，請參閱叢集原則。

根據預設，針對新的受控快取：
- 已啟用 Microsoft Entra ID。
- 存取金鑰驗證基於安全性原因已停用。
這很重要

您無法在建立快取執行個體之後變更模組。模組必須在建立 Azure Managed Redis 實例時啟用。建立快取之後，沒有選項可啟用模組的設定。

這很重要

為了獲得最佳安全性，建議您盡可能使用 Microsoft Entra ID 搭配受控識別來授權對快取的要求。使用 Microsoft Entra 識別碼和受控識別進行授權，可提供優於共用存取密鑰授權的安全性與使用便利性。如需搭配快取使用受控識別的詳細資訊，請參閱使用 Microsoft Entra ID 進行快取驗證。

這很重要

建立 Azure 受控 Redis 實例之後，您無法變更叢集原則。如果您使用 RediSearch，則需要企業叢集原則，而且 NoEviction 是唯一支援的收回原則。

這很重要

如果您在異地複寫群組中使用這個快取執行個體，在建立執行個體之後就無法變更收回原則。建立快取之前，請務必了解主要節點的收回原則。如需關於作用中異地複寫的詳細資訊，請參閱作用中異地複寫必要條件。
選取 [下一步：標記] 並略過。
選取 下一步:檢閱 + 建立。
檢閱設定並選取 [建立]。

Redis 執行個體需要幾分鐘的時間才能建立。您可以在 Azure Managed Redis 的 [概觀] 頁面上監視進度。當 [狀態] 顯示為 [執行中] 時，表示快取已可供使用。

建立 Azure Cache for Redis 執行個體

在 Azure 入口網站中，搜尋並選取 [Azure Cache for Redis]。
在 [Azure Cache for Redis] 頁面上，選取 [建立>Azure Cache for Redis]。
在 [新增 Redis 快取] 頁面的 [基本] 索引卷標上，設定下列設定：
- 訂用帳戶：選取要使用的訂用帳戶。
- 資源群組：選取資源群組，或選取 [ 新建 ]，然後輸入新的資源組名。將所有應用程式資源放在相同的資源群組中，可讓您輕鬆地管理或刪除它們。
- 名稱：輸入區域中唯一的快取名稱。名稱必須：
  - 為 1 到 63 個字元的字串。
  - 只包含數字、字母和連接號。
  - 以數字或字母開頭和結尾。
  - 未包含連續的連字號。
- 區域：選取一個 Azure 區域，使其靠近使用您快取的其他服務。
- 快取 SKU：選取 SKU 以判斷快取可用的大小、效能和功能。
- 快取大小：選取快取大小。如需詳細資訊，請參閱 Azure Cache for Redis 概觀。
選取網路標籤，或選取 下一步：網路。
在 [網路] 索引標籤上，選取要用於快取的連線方法。建議使用私人端點以提高安全性。如果您選取 [私人端點]，請選取 [新增私人端點 ]，然後建立私人端點。
選取 [ 進階] 索引卷標，或選取 [ 下一步：進階]。
在 [ 進階 ] 窗格上，設定下列選項：
- 選取 Microsoft Entra 驗證 或 存取金鑰驗證。 Microsoft Entra Authentication 默認是啟用的。
- 選擇是否 要啟用 非 TLS 埠。
- 針對進階快取，您可以設定或停用 可用性區域。您無法在建立快取後停用可用性區域。針對標準快取，系統會自動配置可用性區域。可用性區域不適用於基本 SKU。
- 針對進階快取，請設定 複本計數、叢集和 分區計數、 系統指派的受控識別和數據 持續性的設定。
下圖顯示標準 SKU 的 [ 進階 ] 索引標籤。

這很重要

盡可能使用 Microsoft Entra ID 搭配受控識別，以授權對快取的要求。使用 Microsoft Entra ID 和受控識別的授權可提供更佳的安全性，而且比共用存取密鑰授權更容易使用。如需搭配快取使用受控識別的詳細資訊，請參閱使用 Microsoft Entra ID 進行快取驗證。
或者，選取 [標籤] 索引標籤或選取 [下一步：標籤]，然後輸入標籤名稱和值以分類您的快取資源。
選取 [檢閱 + 建立]，一旦通過驗證，請選取 [ 建立]。

新的快取部署需要數分鐘的時間。您可以在入口網站 Azure Cache for Redis 頁面上監視部署進度。當快取狀態顯示 [ 執行中] 時，快取即可供使用。

Microsoft Entra 驗證 (建議)

在快取上使用 Microsoft Entra ID 驗證

Azure 受控 Redis 快取預設會啟用Microsoft Entra Authentication。

在 Azure 入口網站中，選取您想要在其中使用 Microsoft Entra 權杖型驗證的快取。
從 [資源] 功能表中選取 [驗證]。
選取 [選取成員]，然後輸入有效使用者的名稱。當您選取 [儲存] 時，您輸入的使用者預設會自動獲指派「資料擁有者存取原則」。您也可以輸入受控識別或服務主體，以連線到快取執行個體。

如需搭配 Azure CLI 使用 Microsoft Entra ID 的詳細資訊，請參閱身分識別的參考頁面。

安裝程式庫以使用 Microsoft Entra ID 驗證

Azure.StackExchange.Redis 程式庫包含 Microsoft Entra ID 驗證方法，以使用 Microsoft Entra ID 連線至 Azure Redis 服務。其適用所有 Azure Cache for Redis、Azure Cache for Redis Enterprise 和 Azure Managed Redis。

在 Visual Studio 中開啟您的專案
以滑鼠右鍵按一下專案，然後選擇 [管理 NuGet 封裝...]
搜尋 Microsoft.Azure.StackExchangeRedis
按一下 [安裝] 按鈕以安裝
接受所有提示的內容以完成安裝

使用 Microsoft Entra ID 連線至快取

在您的程式碼中包括程式庫

using Azure.Identity;
using StackExchange.Redis

使用預設 Azure 認證來驗證用戶端連線。這可讓您的程式碼在本機執行時使用登入使用者認證，而在 Azure 中執行時使用 Azure 受控識別，並且不需要變更程式碼。

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

編輯 web.config 檔案

新增下列內容以編輯 Web.config 檔案：

<appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

將 <cache-hostname> 取代為您的快取主機名稱，如同 Azure 入口網站 [資源] 功能表的 [概觀] 所顯示的名稱。

例如，使用 Azure Managed Redis 或企業層：*my-redis.eastus.azure.net:10000_
儲存檔案。

如需詳細資訊，請參閱 StackExchange.Redis 和 GitHub 存放庫中的程式碼。

編輯 web.config 檔案

新增下列內容以編輯 Web.config 檔案：

<appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

將 <cache-hostname> 取代為您的快取主機名稱，如同 Azure 入口網站 [資源] 功能表的 [概觀] 所顯示的名稱。

例如，使用 Azure Cache for Redis，my-redis.eastus.azure.net:6380
儲存檔案。

如需詳細資訊，請參閱 StackExchange.Redis 和 GitHub 存放庫中的程式碼。

在本機執行應用程式

根據預設，專案已設定為在 IIS Express 本機中裝載應用程式以進行測試和偵錯。

在本機執行應用程式

在 Visual Studio 中，選取 [偵錯]>[開始偵錯] 以在本機建置和啟動要測試和偵錯的應用程式。
在瀏覽器中，選取導覽列上的 [Azure Cache for Redis 測試]。
在下列範例中，Message 金鑰先前具有快取值，此值是在入口網站中使用 Azure Cache for Redis 主控台設定的。應用程式更新了該快取值。應用程式也已執行 PING 和 CLIENT LIST 命令。

在 Azure 中發佈並執行

在本機成功測試應用程式後，您可以將應用程式部署至 Azure 並在雲端執行。

將應用程式發佈至 Azure

在 Visual Studio 的 [方案總管] 中，以滑鼠右鍵按一下專案節點。然後選取 [發佈]。
選取 [Microsoft Azure App Service]、選取 [新建]，然後選取 [發佈]。

在 [建立 App Service] 對話方塊中，進行下列變更：

設定	建議值	說明
應用程式名稱	使用預設值。	應用程式名稱會是應用程式部署至 Azure 時的主機名稱。如有必要，該名稱中會新增時間戳記尾碼，以成為唯一名稱。
訂閱	選擇 Azure 訂用帳戶。	系統會就任何相關的裝載費用，對此訂用帳戶收費。如果您有多個 Azure 訂用帳戶，請確認您已選取所需的訂用帳戶。
資源群組	使用您用來建立快取的相同資源群組 (例如 TestResourceGroup)。	資源群組可協助您以群組管理所有資源。其後當您想要刪除應用程式時，請直接刪除該群組即可。
App Service 計劃	選取 [新增]，然後建立名為 TestingPlan 的新 App Service 方案。使用您在建立快取時所使用的相同位置。選擇免費大小。	App Service 方案會針對要搭配執行的 Web 應用程式定義一組計算資源。

此螢幕擷取畫面顯示 App Service 對話方塊。

在您設定 App Service 裝載設定後，請選取 [建立]。
在 Visual Studio 中監視 [輸出] 視窗，以查看發佈狀態。應用程式發佈之後，系統會記錄應用程式的 URL：

新增快取的應用程式設定

在發佈新的應用程式之後，請新增新的應用程式設定。這項設定會用來儲存快取連線資訊。

新增應用程式設定

若要尋找您所建立的新應用程式，請在 Azure 入口網站頂端的搜尋列中輸入應用程式名稱。
新增名為 CacheConnection 的應用程式設定，以供應用程式用來連線至快取。在 RedisHostName 檔案中使用針對所設定的相同值。

在 Azure 中執行應用程式

在您的瀏覽器中，移至應用程式的 URL。該 URL 會顯示在 Visual Studio [輸出] 視窗中的發佈作業結果內。此外，在 Azure 入口網站中，該 URL 也會提供於您建立的應用程式所屬的 [概觀] 頁面上。
選取導覽列上的 [Azure Cache for Redis 測試] 來測試快取存取，就像使用本機版本一樣。

清理資源

如果您想要繼續使用在本文中建立的資源，請保留該資源群組。

否則，若已完成資源使用，則可刪除您建立的 Azure 資源群組，以避免衍生費用。

這很重要

刪除資源群組是無法回復的動作。當您刪除資源群組時，其中包含的所有資源都將永久刪除。請確定您不會不小心刪除錯誤的資源群組或資源。如果您是在包含需保留資源的現有資源群組內部建立資源，則可以個別刪除每個資源，而不必刪除整個資源群組。

刪除資源群組

登入 Azure 入口網站，然後選取 [資源群組]。
選取您想要刪除的資源群組。

如果有許多資源群組，請使用 [篩選任何欄位] 方塊，並輸入您針對本文所建立資源群組的名稱。選取結果清單中的資源群組。
選擇 ，刪除資源群組。
系統將會要求您確認是否刪除資源群組。輸入您的資源群組名稱以進行確認，然後選取 [刪除]。

不久後，系統便會刪除該資源群組及其所有的資源。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-11-26

共用方式為

快速入門：使用 Azure Redis 搭配 ASP.NET Web 應用程式

跳至 GitHub 上的程式碼

先決條件

建立 Azure 受控 Redis 實例

建立 Azure Cache for Redis 執行個體

Microsoft Entra 驗證 (建議)

在快取上使用 Microsoft Entra ID 驗證

安裝程式庫以使用 Microsoft Entra ID 驗證

使用 Microsoft Entra ID 連線至快取

編輯 web.config 檔案

編輯 web.config 檔案

在本機執行應用程式

在本機執行應用程式

在 Azure 中發佈並執行

將應用程式發佈至 Azure

新增快取的應用程式設定

新增應用程式設定

在 Azure 中執行應用程式

清理資源

刪除資源群組

相關內容

意見反應

其他資源