Gewusst wie: Verwenden des Windows Azure-Zwischenspeicherns

Öffnen Sie das Kontextmenü für das Windows Azure-Projekt, und wählen Sie dann Neues Workerrollenprojekt.

Wählen Sie in der Liste der Projektvorlagen die Vorlage Cache-Worker-Rolle, und geben Sie einen Namen für das Projekt an, z. B. CacheWorkerRole1.

Ein Worker-Rollen-Projekt wird erstellt.

Erweitern Sie unter dem Projekt Windows Azure den Knoten Rollen, öffnen Sie das Kontextmenü für die Cache-Worker-Rolle, die Sie gerade erstellt haben, und wählen Sie Eigenschaften.

Rollen-Designer für dieses Projekt wird angezeigt.

Auf der Registerkarte Konfiguration legen Sie die entsprechende Größe der virtuellen Maschine und die Anzahl der Instanzen für diese Rolle fest.

Auf der Registerkarte Cachedienst beachten Sie, dass unter Cacheclustereinstellungen Dedizierter Cache ausgewählt ist.

Konfigurieren Sie das Verhalten, das Sie für den Standardcache verwenden möchten, oder erstellen Sie benannte Caches mit benutzerdefinierten Eigenschaften.

Jeder benannte Cache hat einen eigenen Satz konfigurierbarer Eigenschaften. Zeigen Sie auf die Tabellenüberschriften zum Anzeigen von Informationen darüber, wie Sie jeden benannten Cache konfigurieren können. Weitere Informationen finden Sie unter Gewusst wie: Konfigurieren des Windows Azure-Zwischenspeicherns.

Klicken Sie im Kontextmenü für den Knoten Verweise unter dem Projekt mit der Rolle, in der Sie einen Cache verwenden möchten, auf Verweis hinzufügen.

Aktivieren Sie im Dialogfeld Verweis hinzufügen die entsprechenden Kontrollkästchen, um Verweise auf die folgenden Assemblys hinzufügen, und wählen Sie dann die Schaltfläche OK:

• Microsoft.ApplicationServer.Caching.AzureClientHelper

• Microsoft.ApplicationServer.Caching.Client

• Microsoft.ApplicationServer.Caching.Core

• Microsoft.Web.DistributedCache

Öffnen Sie im Projekt mit der Rolle, der Sie Zwischenspeicherung hinzufügen möchten, die Datei web.config für ein Webrollenprojekt, oder öffnen Sie die Datei app.config für andere Projekttypen.

Wenn der configSections-Abschnitt nicht vorhanden ist, fügen Sie ihn ein. Fügen Sie in diesem Abschnitt eine Deklaration des Caching-Abschnitt hinzu, wie im folgenden Code gezeigt.

<configSections>
    <section name="dataCacheClients" type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" allowLocation="true" allowDefinition="Everywhere"/>
  </configSections>

Fügen Sie XML hinzu, das den zu verwendenden benannten Cache angibt.

<dataCacheClients>
    <tracing sinkType="DiagnosticSink" traceLevel="Verbose"/>
    <dataCacheClient name="default">
      <autoDiscover isEnabled="true" identifier="WebRole1"/>
    </dataCacheClient>
  </dataCacheClients>

Wenn Sie nur einen Cache deklarieren, kann der Name default lauten, wie im vorherige Beispiel dargestellt. Wenn Sie mehrere Caches deklarieren, fügen Sie einen separaten dataCacheClient-Abschnitt für jeden Cache hinzu und geben Sie jedem Cache einen eindeutigen Namen. Der Cache mit dem Namen default wird zurückgegeben, wenn Sie im Code die GetDefaultCache-Methode für das DataCacheFactory-Objekt aufrufen. Das identifier-Attribut gibt entweder den Namen des Webrollenprojekts, dem Sie Zwischenspeicherunterstützung hinzugefügt haben, oder eine Cache-Worker-Rolle an.

Nun, da Sie einen verteilten Caches in dieser Rolle konfiguriert haben, können Sie aus Code durch Erstellen einer DataCacheFactory und eines DataCache-Objekts darauf zugreifen.

Fügen Sie in einer Code-Behind-Datei Ihrer Page-Klasse Deklarationen hinzu, und fügen Sie einen Zufallszahlengenerator hinzu, sodass Sie einige Daten haben, um den Cache zu testen.

        static DataCacheFactory myFactory;
        static DataCache myCache;
        static Random randomizer = new Random();

Wenn Sie eine Webanwendung erstellen, die den Cache verwendet, ersetzen Sie den Code in der Webseite Default.aspx mit dem folgenden Code.

<%@ Page Title="Home Page" Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true"
    CodeBehind="Default.aspx.cs" Inherits="WebRole1._Default" %>

<asp:Content ID="HeaderContent" runat="server" ContentPlaceHolderID="HeadContent">
</asp:Content>
<asp:Content ID="BodyContent" runat="server" ContentPlaceHolderID="MainContent">
 
     <p style="font-size:large; height: 283px;">
        <asp:Label ID="Label0" runat="server" Text="Text for the cache:   " />
        <asp:TextBox runat="server" ID="TextBox1" Width="125" /> <br /> <br />

        <asp:Button runat="server" onclick="OnPutInCache" Text="Put in Cache" id="AddCachedItemsButton" /> &nbsp;&nbsp;&nbsp;
        <asp:Button runat="server" onclick="OnGetFromCache" Text="Get from Cache" id="GetCachedItemsButton" /> &nbsp;&nbsp;&nbsp;
        <asp:Label ID="Label1" runat="server" Width="500" />

        <br /> <br />  <br /> 
    
        Cached Datestamp: <%= DateTime.Now.ToString() %><br />
        Fresh Datestamp: <asp:Substitution runat="server" methodname="GetFreshDateTime" id="UnCachedArea" /><br /><br />
    </p>

</asp:Content>

Fügen Sie Code zum Initialisieren des Cache hinzu.

        protected void Page_Load(object sender, EventArgs e)
        {
            try
            {
                //Get a named cache (or default cache)
                if (myCache == null)
                {
                    // You should initialize the data cache factory
                    // once and keep reusing the same object.
                    myFactory = new DataCacheFactory();
                    myCache = myFactory.GetDefaultCache();
                    // If you want to get a handle to a named cache
                    // that is not the default cache, supply the
                    // cache's name from the configuration file:
                    // myCache = myFactory.GetCache("anotherNamedCache");
                }
            }
            catch (DataCacheException dce)
            {
                Label1.Text = dce.ToString();
            }
        }

Dieser Initialisierungscode sollte vor jedem Versuch, den Cache zu verwenden, aufgerufen werden. Beispielsweise können Sie diesen Code dem Page_Load-Ereignishandler hinzufügen. Andernfalls wird ein Handle für den Cache mithilfe der Cache-Factory-Methode GetDefaultCache() erstellt. Wenn kein Cachename angegeben ist, wird der Cache mit dem Namen default verwendet. Die Ausnahme DataCacheException kann ausgelöst werden, sobald Sie mit Cache-Methoden arbeiten. Der vorherige Code fängt diese Ausnahme ab und zeigt sie dem Benutzer in einem Label-Steuerelement an.

Fügen Sie Code hinzu, um den Cache zu verwenden.

        /// <summary>
        /// Adds the value of the TextBox to the cache
        /// </summary>
        protected void OnPutInCache(object sender, EventArgs e)
        {
            try
            {
                myCache.Put("MyKey", TextBox1.Text);
                Label1.Text = " \" " + TextBox1.Text + "\" has been added to the cache.";
            }
            catch (DataCacheException dce)
            {
                Label1.Text = dce.ToString();
            }
        }

Im vorherige Beispiel wird ein einfaches Webformular mit einem Textfeld und einer Schaltfläche vorausgesetzt, Sie können jedoch den gleichen Code zum Zwischenspeichern beliebiger Daten verwenden. Wie im Beispiel dargestellt, verwenden Sie die Put-Methode, um Daten zum Cache hinzuzufügen. Der Cache funktioniert wie ein Wörterbuch. Das erste Argument ist der Schlüssel; das zweite Argument sind die Daten, die Sie zwischenspeichern möchten.

Rufen Sie Daten aus der Zwischenspeicherung durch Aufrufen der Get-Methode und Angeben des Schlüssels ab.

        /// <summary>
        /// Gets the cached item (that was added from the TextBox)
        /// </summary>
        protected void OnGetFromCache(object sender, EventArgs e)
        {
            try
            {
                string outputFromCache = myCache.Get("MyKey") as string;
                Label1.Text = "\"" + outputFromCache + "\" has been retrieved from the cache.";
            }
            catch (DataCacheException dce)
            {
                Label1.Text = dce.ToString();
            }
        }

Öffnen Sie die Datei web.config für die ASP.NET-Anwendung, für die Sie die Zwischenspeicherung der Ausgabe konfigurieren möchten.

Fügen Sie die folgenden Zeilen hinzu, um die Ausgabezwischenspeicherung für die Verwendung des verteilten Cache zu konfigurieren.

    <caching>
      <outputCache defaultProvider="defaultProvider" >
        <providers>
          <add cacheName="default"
               name="defaultProvider"
               dataCacheClientName="nameOfDataCacheClient"
               applicationName="<unique-appId>"
               type= "Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache" />
        </providers>
      </outputCache>
    </caching>

Geben Sie für cacheName den Namen des entsprechenden benannten Cache an, der von der angegebenen dataCacheClient gehostet wird. Das dataCacheClient-Attribut gibt die Rolle an, die den Cache hostet.

Fügen Sie die OutputCache-Direktive auf den Seiten hinzu, deren Ausgabe zwischengespeichert werden soll.

<%@ OutputCache Duration="60" VaryByParam="*" %>

Duration ist die Zeitspanne in Sekunden, für die Daten im Cache verbleiben sollen. VaryByParam gibt an, dass für jede Parameterkombination eine andere Version der Seite zwischengespeichert werden soll. Das Sternchen (*) in diesem Zusammenhang bedeutet, bei allen Parametern variieren. Sie können auch Parameter als Namen angeben. Eine vollständige Beschreibung der verfügbaren Optionen finden Sie unter OutputCache-Direktive

Sie haben den Ausgabecache konfiguriert.

Öffnen Sie die Datei web.config für die ASP.NET-Webanwendung, für die Sie die Zwischenspeicherung des Sitzungszustands konfigurieren möchten.

Fügen Sie die folgenden Zeilen hinzu, und geben Sie den Namen des Caches an, den Sie verwenden möchten (in diesem Fall "default"), den Namen des Anbieters, den Namen des dataCacheClient und die Anwendung-AppId.

    <!--Set up custom session state provider -->
    <sessionState mode="Custom" customProvider="defaultProvider">
      <providers>
        <add cacheName="default"
             name="defaultProvider"
             dataCacheClientName="nameOfDataCacheClient"
             applicationName="<unique-appId>"
             type= "Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache"/>
      </providers>
    </sessionState>

Öffnen Sie im Rollen-Designer die Registerkarte Cachedienst für eine Rolle.

Fügen Sie unter Benannte Caches einen benannten Cache für die Ausgabe und einen weiteren für Informationen zum Sitzungszustand hinzu.

In der Tabelle Benannte Caches werden die Eigenschaften für die benannten Caches angezeigt.

Beispielsweise können Sie die Entfernungsrichtlinie für den Ausgabecache auf TTL und für den Sitzungszustandscache auf Keine festlegen.

Öffnen Sie die Datei "web.config", und ändern Sie die Attribute "cacheName" in den Abschnitten "outputCache" und "sessionState" auf die neuen Werte.

Stellen Sie sicher, dass die neueste Version von NuGet installiert ist.

Weitere Informationen und Installationsanweisungen finden Sie unter NuGet.

Öffnen Sie im Projektmappen-Explorer das Kontextmenü für den Projektknoten mit der Rolle, für die Sie die Zwischenspeicherung hinzufügen möchten, und wählen Sie dann NuGet-Pakete verwalten.

Das Dialogfeld NuGet-Pakete verwalten wird angezeigt.

Stellen Sie bei der Juni 2012-Version sicher, dass in der Liste am oberen Rand des Dialogfelds NuGet Pakete verwalten der Wert Vorabversion einschließen und nicht Nur stabile angezeigt wird.

Wählen Sie in der Onlinegalerie Windows Azure-Zwischenspeichern, und klicken Sie dann auf die Schaltfläche Installieren.

Das Projekt wird geändert, es werden Verweise auf Cache-Assemblys hinzugefügt, und die Konfigurationsdateien werden aktualisiert, um einen Cache konfigurieren.

Suchen Sie in der Konfigurationsdatei für das Projekt, das dataCacheClient-Element, das über ein untergeordnetes autoDiscover-Element verfügt.

Ändern Sie in diesem untergeordneten Element den Wert des identifier-Attributs in den Namen der Rolle, die den Cache bereitstellt.

    <dataCacheClient name="default">
      <autoDiscover isEnabled="true" identifier="CacheWorkerRole1"/>
    </dataCacheClient>

Um den Cache zu verwenden, ändern Sie den Code, wie zuvor in diesem Thema beschrieben.

Um einen Ausgabecache oder einen Sitzungszustandscache zu aktivieren, bearbeiten Sie die Konfigurationsdatei für die entsprechende Rolle, und nehmen Sie die anderen Änderungen vor, die zuvor in diesem Thema beschrieben wurden. Für einen programmgesteuerten Cache fügen Sie in Ihren Code-Behind-Dateien den entsprechenden Code ein, um einen Cache zu erstellen und Daten hinzufügen und abrufen zu können.

(optional) Um NuGet-Pakete für eine komplette Projektmappe zu verwalten und mehreren Projekten gleichzeitig eine Unterstützung für die Zwischenspeicherung hinzuzufügen, öffnen Sie das Kontextmenü für den Projektmappenknoten, und wählen Sie NuGet-Pakete verwalten. .