共用方式為

如何：從 Azure 受控快取服務快取新增和移除專案

  • 發行項

重要

Microsoft 建議使用 Azure Redis 快取的所有新開發。 如需選擇 Azure 快取供應專案的目前檔和指引，請參閱 哪一個 Azure 快取供應專案適合我？

下列範例顯示可為快取新增和移除物件的方式。

注意

遵循這些程式之前，請遵循如何：建立適用于 Azure 受控快取服務 的快取和如何：設定 Azure 快取用戶端受控快取服務中的步驟，確定您已建立快取並設定快取用戶端。

將物件新增至快取

  1. 請確定 using 語句 (Visual Basic) 中的 Imports 位於應用程式程式碼頂端，以參考Microsoft.ApplicationServer.Caching命名空間。

  2. 建立 DataCacheFactory 物件，供需要快取用戶端之應用程式的所有部分存取。 如果可能，請儲存並重複使用相同的 DataCacheFactory 物件，以節省記憶體並最佳化效能。

  3. 使用 DataCacheFactory 物件來建立 DataCache 物件 (也稱為快取用戶端) ，或使用預設 DataCache 建構函式直接建立快取用戶端。

  4. 建立 DataCache 物件之後，使用 Add 方法、Put 方法或 Item 屬性將物件新增至快取。 在下列範例中，DataCache 執行個體的名稱為 myCache。

範例

下列範例示範如何使用 Add 方法將物件新增至快取。 若已使用相同的索引鍵 (第一個參數) 來快取物件，會發生例外狀況。

'add string object to cache with key "Key0"
myCache.Add("Key0", "object added with Key0")

//add string object to cache with key "Key0"
myCache.Add("Key0", "object added with Key0");

下列範例使用 Put 方法將物件新增至快取。 若已使用相同的索引鍵來快取物件，則快取中的該物件會被取代。

'add or replace string object in cache using key "Key0"
myCache.Put("Key0", "object replaced or added using Key0")

//add or replace string object in cache using key "Key0"
myCache.Put("Key0", "object replaced or added using Key0");

下列範例使用具有陣列標記法的 Item 屬性將項目新增至快取。 若已使用相同的索引鍵來快取物件，則快取中的該物件會被取代。

'add or replace object in cache using array notation
myCache("Key0") = "object replaced or added using Key0"

//add or replace object in cache using array notation
myCache["Key0"] = "object replaced or added using Key0";

注意

有許多其他參數可供 Add 與 Put 方法使用。 如需詳細資訊，請參閱 DataCache 類別。

從快取移除物件

  • 請確定 using 語句 (Visual Basic) 中的 Imports 位於應用程式程式碼頂端，以參考Microsoft.ApplicationServer.Caching命名空間。

  • 建立 DataCacheFactory 物件，供需要快取用戶端之應用程式的所有部分存取。 如果可能，請儲存並重複使用相同的 DataCacheFactory 物件，以節省記憶體並最佳化效能。

  • 使用 DataCacheFactory 物件來建立 DataCache 物件， (也稱為快取用戶端) 。

  • 建立 DataCache 物件之後，使用 Remove 方法或 Item 屬性將物件從快取移除。 在下列範例中，DataCache 執行個體的名稱為 myCache。

範例

下列範例使用 Remove 方法將物件從快取移除。

'remove object in cache using key "Key0"
myCache.Remove("Key0")

//remove object in cache using key "Key0"
myCache.Remove("Key0");

下列範例使用具有陣列標記法的 Item 屬性將物件從快取移除。

'remove object in cache using array notation
myCache("Key0") = Nothing

//remove object in cache using array notation
myCache["Key0"] = null;

注意

有許多其他參數可供 Remove 方法使用。 如需詳細資訊，請參閱 DataCache 類別。