Guide pratique pour préparer des Visual Studio à utiliser le cache azure In-Role

Cette rubrique explique comment préparer un projet Visual Studio pour utiliser Microsoft Azure Cache. y compris les tâches suivantes :

• Vérifiez que la version correcte de .NET Framework est ciblée.

• Référencez les assemblys de mise en cache.

Après ces tâches, vous pouvez configurer votre client de cache dans la section dataCacheClient de l’application ou des fichiers web.config. Cela vous permet d’utiliser les méthodes de mise en cache dans l’espace de noms Microsoft.ApplicationServer.Caching .

Pour cibler la bonne version du .NET Framework

1. Ouvrez votre projet Visual Studio.

2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Propriétés.

3. Pour un projet Visual C#, procédez comme suit :

   1. Sélectionnez l'onglet Application de la boîte de dialogue Propriétés du projet.

   2. Vérifiez que la version cible est .NET Framework 2.0 ou ultérieur (pour un profil non client).

4. Pour un projet Visual Basic, procédez comme suit :

   1. Sélectionnez la section Compiler de la page Propriétés du projet.

   2. En bas de la page Compiler, cliquez sur Options de compilation avancées.

   3. Vérifiez que la version cible est .NET Framework 2.0 ou ultérieur (pour un profil non client).

Configuration d'un projet pour la mise en cache sur les rôles

Pour ajouter les références d’assembly, le Kit de développement logiciel (SDK) Azure doit être installé sur votre ordinateur. Pour obtenir des instructions, consultez Téléchargement du Kit de développement logiciel (SDK) Azure.

La procédure suivante utilise un package NuGet pour ajouter les références d'assembly et les changements de configuration nécessaires. Ces étapes sont spécifiques à l’utilisation de In-Role Cache hébergé sur un rôle Azure dans le même déploiement.

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Ajouter une référence au package de bibliothèques (NuGet 1.2) ou Gérer les packages NuGet (NuGet 2.0 ou version supérieure).

2. Dans le volet gauche, cliquez sur la catégorie En ligne.

3. Recherchez la valeur WindowsAzure.Caching.

4. Installez le package cache In-Role nommé Microsoft.WindowsAzure.Caching (NuGet 1.2) ou Azure Caching (NuGet 2.0 ou version ultérieure).

   

   

Outre l'ajout des références d'assembly appropriées, ce package modifie également le fichier de configuration (app.config ou web.config) pour le projet ciblé. Il ajoute une section dataCacheClient réutilisable similaire à ce qui suit.

<dataCacheClients>
  <dataCacheClient name="default">
    <autoDiscover isEnabled="true" identifier="[cache cluster role name]" />
    <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
  </dataCacheClient>
</dataCacheClients>

La dernière étape consiste à remplacer l’attribut "[cache cluster role name]"d’identificateur par le nom réel du rôle sur lequel In-Role Cache est activé. "WebRole1"'agir du même rôle (par exemple, ). "CacheWorkerRole1"'agir d'un autre rôle (par exemple, ). Pour obtenir des exemples des deux topologies, consultez Exemples azure In-Role cache.

Le package NuGet ajoute des références aux assemblys suivants :

• Microsoft.ApplicationServer.Caching.AzureClientHelper

• Microsoft.ApplicationServer.Caching.AzureCommon

• Microsoft.ApplicationServer.Caching.Client

• Microsoft.ApplicationServer.Caching.Core

• Microsoft.Web.DistributedCache

• Microsoft.WindowsFabric.Common

• Microsoft.WindowsFabric.Data.Common

Voir aussi

Concepts

Développer pour In-Role Cache Azure
Fournisseurs de cache ASP.NET 4 pour Azure In-Role Cache