Partager via

Guide pratique pour préparer Visual Studio à utiliser azure In-Role Cache

  • Article

Important

Microsoft recommande tous les nouveaux développements d’utiliser le Cache Redis Azure. Pour obtenir de la documentation et des conseils actuels sur le choix d’une offre Azure Cache, consultez Quelle offre Azure Cache est adaptée à moi ?

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

  • Vérifiez que la version correcte du .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 Microsoft.ApplicationServer.Caching.

Avertissement

Vous ne devez pas installer Microsoft AppFabric 1.1 pour Windows Server et Microsoft Azure Cache sur le même ordinateur. Cela inclut à la fois le produit et le Kit de développement logiciel (SDK). Il est possible de référencer par erreur certaines des assemblys Microsoft AppFabric 1.1 pour Windows Server dans le Global Assembly Cache. Cela peut entraîner un comportement incorrect ou inattendu.

Pour cibler la version correcte du .NET Framework

  1. Ouvrez votre projet Visual Studio.

  2. Dans 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 du framework cible est .NET Framework 2.0 ou version ultérieure (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 le bouton Options de compilation avancées.

    3. Vérifiez que la version du framework cible est .NET Framework 2.0 ou version ultérieure (profil non client).

Important

N’utilisez pas le profil client pour la version du framework cible. Dans Visual Studio, sélectionnez les versions du .NET Framework qui ne spécifient pas « Profil client ».

Configurer un projet pour la mise en cache sur les rôles

Pour ajouter les références d’assembly, vous devez installer le Kit de développement logiciel (SDK) Azure sur votre ordinateur. Pour obtenir des instructions, consultez téléchargement du Kit de développement logiciel (SDK) Azure.

Les étapes suivantes utilisent un package NuGet pour ajouter les références d’assembly et les modifications 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 Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Ajouter une référence de package de bibliothèque (NuGet 1.2) ou Gérer les packages NuGet (NuGet 2.0 ou version ultérieure).

  2. Dans le volet gauche, sélectionnez la catégorie Online.

  3. Recherchez 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).

    capture d’écran de capture d’écran du package d’évaluation de mise en cache (NuGet 1.2)

    Capture d’écran de capture d’écran du package d’aperçu de mise en cache (NuGet 2.0)

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 dataCacheClient section 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 à modifier l’identificateur attribut de "[cache cluster role name]" au nom réel du rôle sur lequel In-Role Cache est activé. Dans une topologie colocalisé, il peut s’agir du même rôle, tel que "WebRole1". Dans une topologie dédiée, il peut s’agir d’un rôle différent, tel que "CacheWorkerRole1". Pour obtenir des exemples des deux topologies, consultez Exemples de cache Azure In-Role.

Note

La désinstallation du package NuGet ne supprime pas la section dataCacheClients si cette section a été personnalisée. Elle doit être supprimée manuellement.

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

Note

Il est possible de référencer manuellement ces assemblys sans le package NuGet. Par défaut, ils sont installés sur C :\Program Files\Microsoft SDKs\Azure\.NET SDK< ; version actuelle>\ref\Caching.

Voir aussi

Concepts

Développer pour le cache In-Role Azure
fournisseurs de cache ASP.NET 4 pour azure In-Role Cache