Cette documentation est archivée et n’est pas conservée.

Procédure : Préparation de Visual Studio à l'utilisation d'Azure In-Role Cache

Mis à jour: août 2015

ImportantImportant
Microsoft recommande que tous les nouveaux développements utilisent le Cache Redis Azure. Pour une documentation et des conseils actualisés sur le choix d'une offre de Cache Azure, voir Quelle est l'offre Azure Cache qui me convient ?

Cette rubrique décrit la préparation d'un projet Visual Studio pour faire en sorte que celui-ci utilise la cache Microsoft Azure, y compris les tâches suivantes :

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

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

Une fois ces tâches effectuées, vous pouvez configurer votre client de cache dans la section dataCacheClient des fichiers de l'application ou web.config. Ceci vous permet d'utiliser les méthodes de mise en cache dans l'espace de noms Microsoft.ApplicationServer.Caching.

WarningAvertissement
Vous ne devez pas installer Microsoft AppFabric 1.1 pour Windows Server et la cache Microsoft Azure sur le même ordinateur. Cela comprend le produit et le Kit de développement logiciel (SDK). En effet, il est possible de référencer par erreur certains assemblys de Microsoft AppFabric 1.1 pour Windows Server dans le Global Assembly Cache (GAC). Ceci pourrait entraîner un comportement incorrect ou inattendu.

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

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

Pour ajouter des références d'assembly, le Kit de développement logiciel (SDK) Azure doit être installé sur votre ordinateur. Pour obtenir des instructions, voir 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. Elle s'applique uniquement à l'utilisation de la In-Role Cache hébergée 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 In-Role Cache nommé Microsoft.WindowsAzure.Caching (NuGet 1.2) ou Mise en cache Azure (NuGet 2.0 ou version supérieure).

    Capture d'écran de la version préliminaire du package Caching (NuGet 1,2)

    Capture d'écran de la version préliminaire du package Caching (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 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>

L'étape finale consiste à modifier l'attribut identifier en remplaçant "[cache cluster role name]" par le nom réel du rôle pour lequel la In-Role Cache est activée. Dans une topologie colocalisée, il peut s'agir du même rôle (par exemple, "WebRole1"). Dans une topologie dédiée, il peut s'agir d'un autre rôle (par exemple, "CacheWorkerRole1"). Pour accéder à des exemples des deux topologies, voir Exemples Azure In-Role Cache.

noteRemarque
La désinstallation du package NuGet ne supprime pas la section dataCacheClients si celle-ci 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

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

Voir aussi

Afficher: