(0) exportieren Drucken
Alle erweitern

Vorgehensweise: Konfigurieren eines Cacheclients für Azure Managed Cache Service

Letzte Aktualisierung: Juli 2010

noteHinweis
Hilfestellung bei der Auswahl des für Ihre Anwendung geeigneten Azure Cache-Angebots finden Sie unter Welches Azure-Cacheangebot eigent sich am besten für mich?.

Mit Managed Cache Service ist das Konfigurieren von Cacheclients ganz einfach, da ein NuGet-Paket zum Hinzufügen der erforderlichen Assemblyverweise und Konfiguration bereitgestellt wird. Das NuGet-Paket Cache stellt außerdem auskommentierte Abschnitte in der Datei web.config für Webprojekte zur Verfügung, um die Anbieter für Cachesitzungsstatus und Seitenausgabecache zu aktivieren. In diesem Thema wird eine exemplarische Vorgehensweise zum Konfigurieren von Cacheclients mithilfe des NuGet-Pakets Cache gezeigt.

Das Konfigurieren von Managed Cache Service-Clientanwendungen ist ganz einfach. Managed Cache Service stellt ein NuGet-Paket zum Hinzufügen der erforderlichen Konfiguration und Assemblyverweise zur Verfügung, damit Cacheclients auf einen Cache zugreifen können.

noteHinweis
Managed Cache Service unterstützt -Websites, Cloud Services und Clientanwendungen virtueller Computer. Die Konfigurationsschritte für diese verschiedenen Clientanwendungstypen sind sich sehr ähnlich. Sie weisen nur geringfügige Unterschiede auf. Das NuGet-Paket Cache, das bereitgestellt wird, verarbeitet die meisten dieser Unterschiede automatisch. Eine Beschreibung dieser Unterschiede finden Sie an verschiedenen Stellen in diesem Thema. Eine Zusammenfassung dieser Unterschiede finden Sie unter Cache Service Client Application Types.

Wenn Sie eine Cloud Services-Anwendung erstellen, laden Sie das aktuellste Azure SDK herunter – zurzeit ist dies SDK 2.1. Wenn Sie Azure-Websites oder Clientanwendungen virtueller Computer erstellen, installiert das NuGet-Paket Cache alle Komponenten, die für die ersten Schritte erforderlich sind.

ImportantWichtig
Für diese Schritte ist der aktuelle Paket-Manager von NuGet (Version 2.6.40627.9000 oder höher) erforderlich. Weitere Informationen zum Installieren des aktuellsten Paket-Managers von NuGet finden Sie unter NuGet-Paket-Manager.

Wenn Sie das NuGet-Paket Managed Cache Service verwenden möchten, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Clientprojekt, und wählen Sie dann NuGet-Pakete verwalten aus.

Wählen Sie Azure Caching aus, klicken Sie auf Installieren, und klicken Sie dann auf Ich stimme zu. Nachdem das Paket für das Clientprojekt installiert wurde, klicken Sie auf Schließen, um das Fenster NuGet-Pakete verwalten zu schließen.

noteHinweis
Wenn Azure Caching nicht in der Liste angezeigt wird, geben Sie WindowsAzure.Caching in das Textfeld Online suchen ein.

NuGet-Paket für Windows Azure-Cache

Wenn das NuGet-Paket Managed Cache Service für ein Clientprojekt installiert wurde, fügt es die erforderliche Konfiguration und die Assemblyverweise hinzu, damit die Clientanwendung auf den Cache zugreifen kann.

In der Datei web.config oder app.config für das Clientprojekt werden mehrere Elemente hinzugefügt.

  1. configSections werden zwei Abschnitte namens dataCacheClients und cacheDiagnostics hinzugefügt.

    <!-- Non-cache sections omitted for space -->
      <configSections>
        <section name="dataCacheClients" 
            type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" 
            allowLocation="true" 
            allowDefinition="Everywhere" />
    
        <section name="cacheDiagnostics" 
            type="Microsoft.ApplicationServer.Caching.AzureCommon.DiagnosticsConfigurationSection, Microsoft.ApplicationServer.Caching.AzureCommon" 
            allowLocation="true" 
            allowDefinition="Everywhere" />
      </configSections>
    
  2. Ein Abschnitt dataCacheClients wird dem Abschnitt configuration hinzugefügt.

    <!-- Non-cache sections omitted for space -->
      <dataCacheClients>
        <dataCacheClient name="default">
          <!--To use the in-role flavor of Azure Caching, set identifier to be the cache cluster role name -->
          <!--To use the Azure Caching Service, set identifier to be the endpoint of the cache cluster -->
          <autoDiscover
            isEnabled="true" 
            identifier="[Cache role name or Service Endpoint]" />
          <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
          <!--Use this section to specify security settings for connecting to your cache. 
              This section is not required if your cache is hosted on a role that is a part 
              of your cloud service. -->
          <!--<securityProperties mode="Message" sslEnabled="false">
            <messageSecurity authorizationInfo="[Authentication Key]" />
          </securityProperties>-->
        </dataCacheClient>
      </dataCacheClients>
    
    Ersetzen Sie [Cache role name or Service Endpoint] durch die Endpunkt-URL, die auf dem Cachedashboard im Verwaltungsportal angezeigt wird.

    Endpunkt-URL für Windows Azure Cache Service
    In diesem Beispiel trägt der Cache den Namen applicationcache, und die Endpunkt-URL lautet applicationcache.cache.windows.net.

    <autoDiscover isEnabled="true" identifier="applicationcache.cache.windows.net" />
    
    Heben Sie die Kommentierung des Abschnitts securityProperties auf, und ersetzen Sie dann [Authentication Key] durch den Authentifizierungsschlüssel.

    <!--Use this section to specify security settings for connecting to your cache. 
        This section is not required if your cache is hosted on a role that is a part 
        of your cloud service. -->
    <!--<securityProperties mode="Message" sslEnabled="false">
      <messageSecurity authorizationInfo="[Authentication Key]" />
    </securityProperties>-->
    
    
    Sie ermitteln den Authentifizierungsschlüssel, indem Sie im Verwaltungsportal im Cachedashboard auf Zugriffsschlüssel klicken.

    Tastenkombinationen für Windows Azure Cache Service verwalten
    WarningWarnung
    Diese Einstellungen müssen ordnungsgemäß konfiguriert sein. Andernfalls können Clients nicht auf den Cache zugreifen.

Für Cloud Services-Projekte fügt das NuGet-Paket Managed Cache Service den ConfigurationSettings der Cacheclientrolle in ServiceConfiguration.cscfg außerdem eine Einstellung ClientDiagnosticLevel hinzu. Das folgende Beispiel zeigt den Abschnitt WebRole1 aus einer Datei ServiceConfiguration.cscfg mit einem Wert ClientDiagnosticLevel von 1. Dies ist die Standardeinstellung für ClientDiagnosticLevel.

<Role name="WebRole1">
  <Instances count="1" />
  <ConfigurationSettings>
    <!-- Other settings omitted for space... -->
    <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ClientDiagnosticLevel" value="1" />
  </ConfigurationSettings>
</Role>
noteHinweis
Den Themenbereich zu Cachediagnosestufen finden Sie unter Informationen zu "ClientDiagnosticLevel" für Azure Managed Cache Service.

Neben der erforderlichen Konfiguration fügt das NuGet-Paket Managed Cache Service auch die folgenden Assemblyverweise hinzu.

  • Microsoft.ApplicationServer.Caching.Client.dll

  • Microsoft.ApplicationServer.Caching.Core.dll

  • Microsoft.ApplicationServer.Caching.AzureCommon.dll

  • Microsoft.ApplicationServer.Caching.AzureClientHelper.dll

  • Microsoft.WindowsFabric.Common.dll

  • Microsoft.WindowsFabric.Data.Common.dll

Wenn es sich bei dem Projekt um eine Webprojekt handelt, wird der folgende Assemblyverweis ebenfalls hinzugefügt.

  • Microsoft.Web.DistributedCache.dll

Der Microsoft Azure Cache-Sitzungsstatusanbieter ist ein Out-of-Process-Speichermechanismus für ASP.NET-Anwendungen. Dieser Anbieter ermöglicht das Speichern des Sitzungsstatus in einem Cache (im Gegensatz zu In-Memory oder in einer SQL Server-Datenbank). Wenn Sie das NuGet-Paket Caching zum Aktivieren von Caching verwenden, fügt dieses einen auskommentierten Abschnitt hinzu, um den Cachesitzungsstatusanbieter zu aktivieren.

  1. Konfigurieren Sie zuerst einen Cache, der mit dem ASP.NET-Anbieter verwendet wird. Eine Beschreibung dazu finden Sie im vorherigen Abschnitt Konfigurieren eines Cacheclients mithilfe des NuGet-Pakets Caching.

  2. Entfernen Sie ein ggf. vorhandenes Element sessionState, das den Sitzungsstatuscache konfiguriert. Entfernen Sie nicht den kommentierten Abschnitt sessionState, der vom NuGet-Paket hinzugefügt wurde.

  3. Heben Sie in der Datei web.config die Auskommentierung des Abschnitts sessionState auf.

    <!-- Azure Caching session state provider -->
    <!--<sessionState mode="Custom" customProvider="AFCacheSessionStateProvider">
      <providers>
        <add name="AFCacheSessionStateProvider" type="Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache" cacheName="default" dataCacheClientName="default" applicationName="AFCacheSessionState"/>
      </providers>
    </sessionState>-->
    
    

Die folgende Liste stellt optionale Konfigurationsänderungen zur Verfügung, die sich auf den Sitzungsstatusanbieter auswirken.

  • Ändern des benannten Zielcaches mit dem Attribut cacheName des Elements add.

  • Ändern der Quelle der Cacheclienteinstellungen mit dem Attribut dataCacheClientName des Elements add. Legen Sie dieses Attribut auf den Namen eines vorhandenen Abschnitts dataCacheClient in der Datei web.config fest.

  • Ändern des Verhaltens des Cacheclients, indem die Einstellungen im zugehörigen Abschnitt dataCacheClient geändert werden. Aktivieren Sie z. B. Komprimierung mit dem Attribut isCompressionEnabled.

    <dataCacheClient name="default" isCompressionEnabled="true">
      <!-- Other cache settings omitted -->
    </dataCacheClient>
    
    Eine Liste der verfügbaren Konfigurationsoptionen finden Sie unter Konfigurationseinstellungen des Cacheclients für Azure Managed Cache Service. Beachten Sie, dass die ASP.NET-Anbieter für Zwischenspeichern keine binären oder benutzerdefinierten Serialisierungstypen unterstützen. Wenn diese Serialisierer für den Sitzungsstatus verwendet werden, tritt die folgende Ausnahme auf: "Der Typ "Microsoft.Web.DistributedCache.SerializableSessionStateStoreData" in der Assembly "Microsoft.Web.DistributedCache, Version=101.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" ist nicht als serialisierbar markiert."

  • Ändern der Einstellungen für den Sitzungsstatusanbieter. Eine Liste der verfügbaren Konfigurationsoptionen finden Sie unter Konfigurationseinstellungen des ASP.NET-Sitzungsstatusanbieters für Azure Managed Cache Service.

Der Microsoft Azure Cache-Ausgabecache ist ein Out-of-Process-Speichermechanismus für Ausgabecachedaten. Diese Daten beziehen sich auf vollständige HTTP-Antworten (Seitenausgabecache). Der Anbieter verwendet den neuen Erweiterungspunkt des Ausgabecacheanbieters, der in ASP.NET 4 eingeführt wurde. Wenn Sie das NuGet-Paket Caching zum Aktivieren von Caching verwenden, fügt dieses einen auskommentierten Abschnitt hinzu, um den Seitenausgabeanbieter des Caches zu aktivieren.

  1. Konfigurieren Sie zuerst einen Cache, der mit dem ASP.NET-Anbieter verwendet wird. Eine Beschreibung dazu finden Sie im vorherigen Abschnitt Konfigurieren eines Cacheclients mithilfe des NuGet-Pakets Caching.

  2. Verwenden Sie NuGet zum Hinzufügen von Zwischenspeichern-Unterstützung zu Ihrem ASP.NET-Projekt in Visual Studio. Anweisungen finden Sie unter Prepare Visual Studio for Azure Cache Service Client Application Development.

    ImportantWichtig
    Für diese Schritte ist der aktuelle Paket-Manager von NuGet (Version 2.6.40627.9000 oder höher) erforderlich. Weitere Informationen zum Installieren des aktuellsten Paket-Managers von NuGet finden Sie unter NuGet-Paket-Manager.

  3. Entfernen Sie ein ggf. vorhandenes Element caching, das den Ausgabecache konfiguriert. Entfernen Sie nicht den kommentierten Abschnitt caching, der vom NuGet-Paket hinzugefügt wurde.

  4. Heben Sie in der Datei web.config die Auskommentierung des Abschnitts caching auf.

        <!-- Azure Caching output caching provider -->
        <!--Uncomment this section to use Azure Caching for output caching-->
        <!--<caching>
          <outputCache defaultProvider="AFCacheOutputCacheProvider">
            <providers>
              <add name="AFCacheOutputCacheProvider" 
                type="Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache"
                cacheName="default"
                dataCacheClientName="default"
                applicationName="AFCacheOutputCache" />
            </providers>
          </outputCache>
        </caching>-->
    

Die folgende Liste stellt optionale Konfigurationsänderungen zur Verfügung, die sich auf den Ausgabecacheanbieter auswirken.

  • Ändern des benannten Zielcaches mit dem Attribut cacheName des Elements add.

  • Ändern der Quelle der Cacheclienteinstellungen mit dem Attribut dataCacheClientName des Elements add. Legen Sie dieses Attribut auf den Namen eines vorhandenen Abschnitts dataCacheClient in der Datei web.config fest.

  • Ändern des Verhaltens des Cacheclients, indem die Einstellungen im zugehörigen Abschnitt dataCacheClient geändert werden. Aktivieren Sie z. B. Komprimierung mit dem Attribut isCompressionEnabled.

    <dataCacheClient name="default" isCompressionEnabled="true">
    
    Eine Liste der verfügbaren Konfigurationsoptionen finden Sie unter Konfigurationseinstellungen des Cacheclients für Azure Managed Cache Service. Beachten Sie, dass die ASP.NET-Anbieter für Zwischenspeichern keine binären oder benutzerdefinierten Serialisierungstypen unterstützen.

  • Ändern der Einstellungen für den Ausgabecacheanbieter. Eine Liste der verfügbaren Konfigurationsoptionen finden Sie unter Konfigurationseinstellungen des ASP.NET-Seitenausgabeanbieters des Caches für Azure Managed Cache Service.

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft