Vorgehensweise: Vorbereiten von Visual Studio für die Verwendung von Azure In-Role Cache

In diesem Thema wird erläutert, wie Sie ein Visual Studio Projekt vorbereiten, um Microsoft Azure Cache zu verwenden. Dies umfasst die folgenden Aufgaben:

• Sicherstellen, dass die richtige Version von .NET Framework verwendet wird.

• Verweisen Sie auf die Zwischenspeicherungsassemblys.

Nach diesen Aufgaben können Sie Ihren Cacheclient im DataCacheClient-Abschnitt der Anwendung oder web.config Dateien konfigurieren. Dadurch können Sie die Zwischenspeichermethoden im Microsoft.ApplicationServer.Cache-Namespace verwenden.

So legen Sie die richtige Version von .NET Framework fest

1. Öffnen Sie Ihr Visual Studio-Projekt.

2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und wählen Sie dann Eigenschaften aus.

3. Führen Sie für ein Visual C#-Projekt die folgenden Schritte aus:

   1. Wählen Sie im Dialogfeld Projekteigenschaften die Registerkarte Anwendung aus.

   2. Überprüfen Sie, ob die Zielversion des Frameworks .NET Framework 2.0 oder höher ist (Nicht-Clientprofil).

4. Führen Sie für ein Visual Basic-Projekt die folgenden Schritte aus:

   1. Wählen Sie den Abschnitt Kompilieren der Seite Projekteigenschaften aus.

   2. Klicken Sie unten auf der Seite Kompilieren auf die Schaltfläche Erweiterte Kompilierungsoptionen.

   3. Überprüfen Sie, ob die Zielversion des Frameworks .NET Framework 2.0 oder höher ist (Nicht-Clientprofil).

Konfigurieren eines Projekts für Caching für Rollen

Um die Assemblybezüge hinzuzufügen, müssen Sie das Azure SDK auf Ihrem Computer installiert haben. Anweisungen finden Sie im Azure SDK-Download.

In den folgenden Schritten wird ein NuGet-Paket zum Hinzufügen der erforderlichen Assemblyverweise und Konfigurationsänderungen verwendet. Diese Schritte sind speziell für die Verwendung von In-Role Cache, der in einer Azure-Rolle in derselben Bereitstellung gehostet wird.

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und wählen Sie dann Bibliothekspaketverweis hinzufügen (NuGet 1.2) oder NuGet-Pakete verwalten (NuGet 2.0 oder höher) aus.

2. Wählen Sie im linken Fensterbereich die Kategorie Online aus.

3. Suchen Sie nach WindowsAzure.Caching.

4. Installieren Sie das In-Role Cachepaket namens Microsoft.WindowsAzure.Caching (NuGet 1.2) oder Azure Cache (NuGet 2.0 oder höher).

   

   

Dieses Paket fügt nicht nur die entsprechenden Assemblyverweise hinzu, sondern ändert auch die Konfigurationsdatei (app.config oder web.config) für das Zielprojekt. Es fügt einen DataCacheClient-Abschnitt wie folgt hinzu.

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

Der letzte Schritt besteht darin, das Bezeichnerattribute in "[cache cluster role name]" den tatsächlichen Namen der Rolle zu ändern, die In-Role Cache aktiviert ist. In einer zusammengestellten Topologie kann es sich um die gleiche Rolle handeln, z. B. um "WebRole1". In einer dedizierten Topologie kann es sich um eine andere Rolle handeln, z. B. um "CacheWorkerRole1". Beispiele für beide Topologien finden Sie unter Azure In-Role Cachebeispiele.

Das NuGet-Paket fügt Verweise auf die folgenden Assemblys hinzu:

• 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

Weitere Informationen

Konzepte

Entwickeln für Azure In-Role Cache
ASP.NET 4-Cacheanbieter für Azure In-Role Cache