Vorgehensweise: Hinzufügen und Entfernen von Elementen aus einem Azure-In-Role-Cache

Wichtig

Microsoft empfiehlt, alle neuen Entwicklungen azure Redis Cache zu verwenden. Für aktuelle Dokumentation und Anleitungen zur Auswahl eines Azure Cache-Angebots finden Sie unter Welches Azure Cache-Angebot ist für mich richtig?

Die folgenden Beispiele veranschaulichen die verschiedenen Möglichkeiten, wie Objekte zum Cache hinzugefügt bzw. aus ihm entfernt werden können.

Hinweis

In diesen Vorgehensweisen wird angenommen, dass der Cachecluster bereits eingerichtet und die Entwicklungsumgebung bereits vorbereitet wurde.

So fügen Sie dem Cache ein Objekt hinzu

  1. Stellen Sie sicher, dass die Using-Anweisung (Imports in Visual Basic) oben im Anwendungscode liegt, um auf den Microsoft.ApplicationServer.Cache-Namespace zu verweisen.

  2. Erstellen Sie ein DataCacheFactory-Objekt , das für alle Teile der Anwendung zugänglich ist, die einen Cacheclient benötigen. Speichern Sie nach Möglichkeit das gleiche DataCacheFactory-Objekt, und verwenden Sie es erneut, um Speicher zu sparen und die Leistung zu verbessern.

  3. Verwenden Sie das DataCacheFactory-Objekt , um ein DataCache-Objekt zu erstellen (auch als Cacheclient bezeichnet), oder verwenden Sie den Standarddatencache-Konstruktor , um einen Cacheclient direkt zu erstellen.

  4. Verwenden Sie nach dem Erstellen des DataCache-Objekts die Methode Add, die Methode Put oder die Eigenschaft Item, um dem Cache ein Objekt hinzuzufügen. Im folgenden Beispiel weist die DataCache-Instanz den Namen myCache auf.

Beispiel

Das folgenden Beispiel zeigt die Verwendung der Methode Add zum Hinzufügen eines Objekts zum Cache. Eine Ausnahme wird zurückgegeben, wenn bereits ein Objekt mit dem gleichen Schlüssel (dem ersten Parameter) im Cache vorhanden ist.

'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");

Im folgenden Beispiel wird die Put-Methode zum Hinzufügen eines Objekts zum Cache verwendet. Wenn bereits in Objekt mit dem gleichen Schlüssel im Cache vorhanden ist, wird es ersetzt.

'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");

Im folgenden Beispiel wird die Eigenschaft Item, die eine Arrayschreibweise aufweist, zum Hinzufügen eines Elements zum Cache verwendet. Wenn bereits in Objekt mit dem gleichen Schlüssel im Cache vorhanden ist, wird es ersetzt.

'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";

Hinweis

Für die Methoden Add und Put stehen viele weitere Parameter zur Verfügung. Weitere Informationen finden Sie in der DataCache-Klasse .

So entfernen Sie ein Objekt aus dem Cache

  • Stellen Sie sicher, dass die Using-Anweisung (Imports in Visual Basic) oben im Anwendungscode liegt, um auf den Microsoft.ApplicationServer.Cache-Namespace zu verweisen.

  • Erstellen Sie ein DataCacheFactory-Objekt , das für alle Teile der Anwendung zugänglich ist, die einen Cacheclient benötigen. Speichern Sie nach Möglichkeit das gleiche DataCacheFactory-Objekt, und verwenden Sie es erneut, um Speicher zu sparen und die Leistung zu verbessern.

  • Verwenden Sie das DataCacheFactory-Objekt , um ein DataCache-Objekt zu erstellen (auch als Cacheclient bezeichnet).

  • Verwenden Sie nach dem Erstellen des DataCache-Objekts die Methode Remove oder die Eigenschaft Item, um ein Objekt aus dem Cache zu entfernen. Im folgenden Beispiel weist die DataCache-Instanz den Namen myCache auf.

Beispiel

Im folgenden Beispiel wird die Methode Remove zum Entfernen eines Objekts aus dem Cache verwendet.

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

Im folgenden Beispiel wird die Item-Eigenschaft, die eine Arrayschreibweise aufweist, zum Entfernen eines Objekts aus dem Cache verwendet.

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

Hinweis

Für die Methode Remove stehen viele weitere Parameter zur Verfügung. Weitere Informationen finden Sie in der DataCache-Klasse .