Préparation de l'environnement de développement du client de cache (mise en cache de Windows Server AppFabric)

Article
12/05/2011

Cette rubrique décrit la préparation de votre projet Visual Studio pour commencer à développer des applications prenant en charge le cache. Les procédures suivantes supposent que vous avez déjà installé Windows Server AppFabric et configuré les fonctionnalités de mise en cache d'AppFabric sur un ou plusieurs serveurs de cache, ou sur votre station de travail de développement. Pour plus d'informations, consultez le document Windows Server AppFabric Installation Guide (https://go.microsoft.com/fwlink/?LinkId=164929) (en anglais).

Outre l'installation des fonctionnalités de mise en cache d'AppFabric, vous devez effectuer les opérations suivantes pour permettre au client de cache d'accéder au cache :

Dans Windows PowerShell, utilisez la commande Use-CacheCluster pour définir le contexte sur le cluster de cache cible.
Créez les caches nommés nécessaires à l'aide de la commande New-Cache.
Accordez l'accès au compte Windows du client de cache à l'aide de la commande Grant-CacheAllowedClientAccount.
Démarrez le cluster de cache à l'aide de la commande Start-CacheCluster.

Pour plus d'informations sur l'utilisation de Windows PowerShell et les commandes énumérées ici, consultez la rubrique Utilisation de Windows PowerShell pour la gestion des fonctionnalités de mise en cache de Windows Server AppFabric.

Préparation de l'ordinateur de développement

Pour développer une application basée sur les fonctionnalités de mise en cache d'AppFabric, la fonctionnalité de client de cache d'AppFabric doit impérativement être installée. S'il est possible de développer des applications sur un hôte de cache sur lequel d'autres fonctionnalités de mise en cache d'AppFabric sont installées, le client de cache est la seule fonctionnalité requise sur la station de travail de développement.

Préparation du projet Visual Studio

Les assemblys requis pour le développement d'applications prenant en charge le cache sont installés dans le GAC (Global Assembly Cache). Pour développer une application .NET Visual Studio qui utilise ces assemblys, vous devez les référencer à partir de votre projet.

Pour cibler la bonne version du .NET Framework

Ouvrez votre projet .NET Visual Studio.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Propriétés.
Sélectionnez l'onglet Application de la boîte de dialogue Propriétés du projet.
Vérifiez que la version cible est .NET Framework 2.0 ou ultérieur.

Important

N'utilisez pas le profil du client pour la version du .NET Framework cible Dans Visual Studio 2008, désactivez la case à cocher Sous-ensemble du Framework client seulement. Dans Visual Studio 2010, sélectionnez les versions du .NET Framework qui ne spécifient pas « Profil du client ».

Pour ajouter des références aux assemblys de mise en cache d'AppFabric

Ouvrez votre projet .NET Visual Studio.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Ajouter une référence.
Sélectionnez l'onglet Parcourir de la boîte de dialogue Ajouter une référence.
Accédez au répertoire .\Windows\System32\AppFabric.

Notes

Sur les systèmes d'exploitation 64 bits, le répertoire d'AppFabric n'est pas directement visible. Pour contourner ce problème, remplacez le nom de répertoire System32 par SysNative. Ceci permet d'accéder au répertoire C:\Windows\SysNative\AppFabric.
Ajoutez une référence aux assemblys suivants : Microsoft.ApplicationServer.Caching.Client.dll et Microsoft.ApplicationServer.Caching.Core.dll.
Ajoutez l'instruction Using (Imports dans Visual Basic) dans la partie supérieure des fichiers de code pour référencer l'espace de noms Microsoft.ApplicationServer.Caching (facultatif).

Pour configurer le client de cache

Déterminez les paramètres de client appropriés pour l'application cliente. Pour plus d'informations sur les types de clients de cache, consultez la rubrique Clients de cache et cache local (mise en cache de Windows Server AppFabric).
Configurez votre client de cache par programme ou à l'aide d'un fichier de configuration d'application. Pour obtenir des exemples de configuration, consultez les rubriques Prise en main d'un client de cache de Windows Server AppFabric et Prise en main d'un client de cache de Windows Server AppFabric (XML).

Exemple

L'exemple suivant illustre la configuration d'un client de cache à l'aide d'un fichier de configuration d'application. Le cache local est désactivé et deux hôtes de cache sont répertoriés : CacheServer1 et CacheServer2. Pour plus d'informations, consultez la rubrique Prise en main d'un client de cache de Windows Server AppFabric (XML).

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <!--configSections must be the FIRST element -->
   <configSections>
      <!-- required to read the <dataCacheClient> element -->
      <section name="dataCacheClient"
         type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
            Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, 
            Culture=neutral, PublicKeyToken=31bf3856ad364e35"
         allowLocation="true"
         allowDefinition="Everywhere"/>
   </configSections>

   <dataCacheClient>
      <!-- (optional) specify local cache
      <localCache
         isEnabled="true"
         sync="TimeoutBased"
         objectCount="100000"
         ttlValue="300" /> -->

      <!--(optional) specify cache notifications poll interval
      <clientNotification pollInterval="300" /> -->

      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

L'exemple suivant illustre la configuration d'un client par programme. Le cache local est désactivé, référence un serveur de cache (CacheServer2) et crée un client de cache pour le cache nommé NamedCache1. Pour plus d'informations, consultez la rubrique Prise en main d'un client de cache de Windows Server AppFabric.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

Voir aussi

Concepts

Autres ressources

Configuration du client de cache avec XML

2011-12-05

Partager via