Freigeben über

Konfigurationseinstellungen für den ASP.NET 4-Cache-Ausgabecacheanbieter (AppFabric 1.1-Cache)

  • Artikel

In diesem Thema werden die Konfigurationseinstellungen für den Microsoft AppFabric 1.1 für Windows Server-Ausgabecacheanbieter für ASP.NET behandelt. Diese Einstellungen werden im Abschnitt providers des Elements outputCache in der Datei web.config angegeben.

Sitzungsstatus-Konfigurationseinstellungen

Attribut Beschreibung

name (erforderlich)

Der Anzeigename des Anbieters, der vom Element outputCache verwendet wird, um auf den Anbieter zu verweisen.

type (erforderlich)

Die .NET Framework-Typzeichenfolge für den Anbieter. Diese Angabe sollte auf “Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache” festgelegt werden.

cacheName (erforderlich)

Der Name des AppFabric-Caches.

dataCacheClientName (optional)

Der Name des Abschnitts dataCacheClient, der aus dem Konfigurationsabschnitt dataCacheClients verwendet werden soll. Dieses Attribut ist nur erforderlich, wenn mehrere Abschnitte dataCacheClient in der Datei web.config angegeben werden. Standardmäßig verwendet der Anbieter den Abschnitt dataCacheClient namens “default”.

applicationName (optional)

Ein vom Anbieter beim Erstellen von Cacheschlüsseln zum Speichern der Ausgabecachedaten verwendeter Zeichenfolgenwert. Der Standardwert ist eine leere Zeichenfolge. Wenn dieses Attribut nicht festgelegt ist, verwendet der Anbieter den Wert von HttpRuntime.AppDomainAppId als Teil der intern verwendeten Cacheschlüssel. Im Gegensatz zur Sitzungsstatusfunktion möchten Sie Ausgabecachedaten nicht für verschiedene ASP.NET-Anwendungen gemeinsam verwenden (/contoso und /AdventureWorks können z. B. Ausgabecachedaten nicht gemeinsam verwenden). Stellen Sie stattdessen sicher, dass verschiedene physische Instanzen der gleichen Anwendung Zugriff auf die gleichen Ausgabecachedaten besitzen. Dies kann auf zwei unterschiedliche Arten erfolgen:

  • Wenn das Anbieterattribut applicationName nicht ausdrücklich festgelegt ist, wird HttpRuntime.AppDomainAppId intern vom Anbieter beim Generieren von Cacheschlüsseln verwendet. Dies bedeutet, dass jede physische Instanz der gleichen Anwendung (d. h., jeder Webserver, der die Anwendung /contoso hostet), in IIS mit dem genau gleichen Metabasispfad installiert sein muss. Erläuterungen dazu, wie Metabasispfade mit SQL Server und Out-of-Process-Sitzungsstatusanbietern verwendet werden, finden Sie unter https://support.microsoft.com/kb/325056. Obwohl der Sitzungsstatus eine andere Funktion darstellt, besteht auch hier das Problem, die Metabasispfade zu synchronisieren. Dies gilt für Ausgabecaches, wenn das Attribut applicationName nicht in der Datei web.config festgelegt wurde.

  • Eine einfachere Vorgehensweise besteht darin, für jede Instanz der gleichen ASP.NET-Anwendung (z. B. auf jedem Webserver, der die Anwendung /contoso hostet) das gleiche Attribut applicationName in der Datei web.config zu verwenden. Auf diese Weise können verschiedene physische Instanzen der gleichen Anwendung aus dem gleichen Ausgabecachedaten lesen und in diesen schreiben. In diesem Fall verwendet der Anbieter nicht AppDomainAppId, wenn er Cacheschlüssel generiert. Aus diesem Grund besteht kein Risiko, dass nicht übereinstimmende Metabasispfade vorliegen.

retryInterval (optional)

Die Zeitspanne, die zwischen Wiederholungsversuchen gewartet wird, wenn ein Fehler bei der Kommunikation mit dem Cache auftritt. Das Zeichenfolgenformat, das für diesen Wert verwendet werden muss, ist "HH:MM:SS". Standardmäßig wartet der Anbieter eine Sekunde lang.

retryCount (optional)

Ein ganzzahliger Wert, der dem Anbieter die Anzahl der Wiederholungsversuche mitteilt, wenn ein Kommunikationsfehler mit dem Cache auftritt. Beachten Sie, dass nicht für alle Vorgänge Wiederholungsversuche ausgeführt werden können. Der Standardwert sind drei Wiederholungsversuche. Der Anbieter wartet für die konfigurierte Zeitspanne retryInterval zwischen den einzelnen Wiederholungsversuchen.

Beispiel

Das folgende Beispiel zeigt ein Element outputCache, das AppFabric-Cache verwendet.

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

Siehe auch

Konzepte

Ausgabecacheanbieter (AppFabric 1.1-Cache)

  2012-03-05