Exemple d'utilisation de l'API de mise en cache d'AppFabric

Cet exemple montre l'utilisation de plusieurs API de mise en cache d'AppFabric.

Notes

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucune assistance technique pour ces exemples.

Conditions préalables

Idéalement, les utilisateurs doivent disposer de certaines connaissances relatives aux scripts Windows PowerShell.

Cet exemple repose sur les hypothèses suivantes :

• Windows PowerShell 2.0 est installé.

• Microsoft AppFabric 1.1 pour Windows Server est installé. (Cela ajoute les DLL requises au GAC.)

Configuration du cache d'AppFabric

Si ce n'est encore fait, configurez le cache d'AppFabric à l'aide de l'outil de configuration de Microsoft AppFabric 1.1 pour Windows Server (utilisez les paramètres par défaut). Cet exemple suppose qu'un cache AppFabric est configuré avec des paramètres par défaut (cacheHostName=AppFabricCachingService et cacheName=default).

Démarrage du cluster de cache

1. Ouvrez une fenêtre de commande Windows PowerShell en mode d'exécution élevé, puis exécutez la commande suivante pour ajouter le module d'administration de cache distribué :

   Import-Module DistributedCacheAdministration
   

2. La commande Use-CacheCluster permet de définir le contexte de votre session Windows PowerShell sur le cluster de cache souhaité. Celle-ci peut être exécutée sans paramètre pour utiliser les paramètres de connexion fournis quand le composant Administration du cache d'Mise en cache d'AppFabric a été configuré.

3. Exécutez la commande suivante pour octroyer à un compte d'utilisateur l'accès au cluster de cache en tant que client. Fournissez vos nom d'utilisateur et de domaine.

   Grant-CacheAllowedClientAccount domain\username
   

4. La commande Get-CacheAllowedClientAccounts permet de vérifier si votre compte d'utilisateur dispose d'un accès.

5. Démarrez le cluster à l'aide de la commande Start-CacheCluster.

Créez et exécutez cet exemple.

1. Ouvrez le fichier de solution CacheAPI.sln dans Visual Studio. L'exemple établit automatiquement une liaison avec les DLL de cache d'AppFabric (Microsoft.ApplicationServer.Caching.Client.dll et Microsoft.ApplicationServer.Caching.Core.dll) à partir du GAC. L'exemple montre les modes d'utilisation suivants :

   • Remove/Create par rapport à une région nommée

   • Simple Add/Get par rapport au cache/à la région par défaut

   • Add/Get par rapport à une région nommée dans le cache par défaut

   • Add/Get/GetAndLock/GetIfNewer/Put/PutAndUnlock par rapport à une région nommée. Variations :

     • GetAndLock par rapport à une tentative d'accès à un objet verrouillé

     • PutAndUnlock par rapport à une tentative de déverrouillage d'un objet non verrouillé

   • Add/Get/Put par rapport à un objet dont les versions sont suivies

     • Modifier explicitement un élément uniquement si les versions correspondent

     • Ne pas modifier un élément si un élément plus récent est disponible dans le cache.

   • Simple Add/GetByTag par rapport à l'utilisation d'indicateurs

   Notes

   Lors des exécutions suivantes de cet exemple, utilisez la commande Restart-CacheCluster pour effacer le cache, puis patientez entre 10 et 15 secondes.

Suppression de l'exemple

Redémarrez le cluster de cache à l'aide de la commande Restart-CacheCluster pour nettoyer les données du cache.

Voir aussi

Autres ressources

Exemples (mise en cache d'AppFabric 1.1)

  2012-03-05