Beispiel für die Verwendung der AppFabric-Cache-API

Artikel
03/05/2012

Dieses Beispiel zeigt die Verwendung verschiedener AppFabric-Cache-APIs.

Hinweis

Beispiele werden nur zu Anschauungszwecken bereitgestellt. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet keinen technischen Support für diese Beispiele.

Voraussetzungen

Idealerweise sollten die Benutzer über Kenntnisse im Skripten in Windows PowerShell verfügen.

Das Beispiel setzt Folgendes voraus:

Windows PowerShell 2.0 ist installiert.
Microsoft AppFabric 1.1 für Windows Server ist installiert. (Dadurch werden außerdem dem GAC die erforderlichen DLLs hinzugefügt.)

Konfigurieren des AppFabric-Caches

Wenn dies noch nicht erfolgt ist, konfigurieren Sie den AppFabric-Cache mithilfe des Microsoft AppFabric 1.1 für Windows Server-Konfigurationstools (verwenden Sie die Standardeinstellungen). In dem Beispiel wird angenommen, dass ein AppFabric-Cache mit den Standardeinstellungen konfiguriert ist (cacheHostName=AppFabricCachingService und cacheName=default).

Starten des Cacheclusters

Öffnen Sie ein Windows PowerShell-Befehlsfenster mit erhöhten Rechten, und führen Sie den folgenden Befehl aus, um das Verwaltungsmodul für den verteilten Cache hinzuzufügen:
```
Import-Module DistributedCacheAdministration
```
Verwenden Sie den Befehl Use-CacheCluster, um den Kontext der Windows PowerShell-Sitzung auf den gewünschten Cachecluster festzulegen. Der Befehl kann ohne Parameter ausgeführt werden und verwendet dann die beim Konfigurieren der AppFabric-Cache-Verwaltungskomponente angegebenen Verbindungsparameter.
Führen Sie den folgenden Befehl aus, um Ihrem Benutzerkonto Zugriff auf den Cachecluster als Client zu erteilen. Geben Sie den Benutzer- und Domänennamen an.
```
Grant-CacheAllowedClientAccount domain\username
```
Verwenden Sie den Befehl Get-CacheAllowedClientAccounts, um zu überprüfen, ob Ihrem Benutzerkonto der Zugriff erteilt wurde.
Start den Sie den Cluster mithilfe des Befehls Start-CacheCluster.

Erstellen und Ausführen des Beispiels

Öffnen Sie eine CacheAPI.sln-Projektmappendatei in Visual Studio. Das Beispiel stellt automatisch eine Verknüpfung mit den AppFabric-Cache-DLLs (Microsoft.ApplicationServer.Caching.Client.dll und Microsoft.ApplicationServer.Caching.Core.dll) aus dem globalen Assemblycache (GAC) her. Das Beispiel veranschaulicht die folgenden Verwendungsmuster:
- Remove/Create (Entfernen/Erstellen) eines benannten Bereichs
- Simple Add/Get (Einfaches Hinzufügen zum/Abrufen aus dem) Beispielcache/-bereich
- Add/Get (Hinzufügen zu/Abrufen aus einem) benannten Bereich im Standardcache
- Add/Get/GetAndLock/GetIfNewer/Put/PutAndUnlock (Hinzufügen/Abrufen/AbrufenUndSperren/AbrufenFallsNeuer/Festlegen/FestlegenUndEntsperren) zu einem benannten Bereich. Variationen:
  - GetAndLock (AbrufenUndSperren) beim Versuch, auf ein gesperrtes Objekt zuzugreifen
  - PutAndUnlock (FestlegenUndEntsperren) beim Versuch, die Sperre eines nicht gesperrten Objekts aufzuheben
- Add/Get/Put (Hinzufügen/Abrufen/Festlegen) eines versionierten Objekts
  - Explizites Ändern eines Elements nur bei übereinstimmender Version
  - Fehler beim Ändern eines Elements, wenn ein neueres Element im Cache verfügbar ist.
- Simple Add/GetByTag (Einfaches Hinzufügen/AbrufenNachTag), um die Verwendung von Tags anzuzeigen
Hinweis

Verwenden Sie für jede nachfolgende Ausführung dieses Beispiels den Befehl Restart-CacheCluster, um den Cache zu leeren, und und warten Sie dann 10-15 Sekunden.

Entfernen dieses Beispiels

Starten Sie den Cachecluster erneut mithilfe des Befehls Restart-CacheCluster, um Daten aus dem Cache zu entfernen.

Siehe auch

Weitere Ressourcen

Beispiele (AppFabric 1.1-Cache)

2012-03-05

Freigeben über