Konfigurationseinstellungen für den ASP.NET 4-Cache-Sitzungsstatusanbieter (AppFabric 1.1-Cache)
In diesem Thema werden die Konfigurationseinstellungen für den AppFabric-Sitzungsstatusanbieter für ASP.NET behandelt. Diese Einstellungen werden im Abschnitt providers des Elements sessionState in der Datei web.config angegeben.
Sitzungsstatus-Konfigurationseinstellungen
| Attribut | Beschreibung |
|---|---|
name (erforderlich) |
Der Anzeigename des Anbieters, der vom Element sessionState verwendet wird, um auf den Anbieter zu verweisen. |
type (erforderlich) |
Die .NET Framework-Typzeichenfolge für den Anbieter. Diese Angabe sollte auf |
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 |
applicationName (optional) |
Ein vom Anbieter beim Erstellen von Cacheschlüsseln zum Speichern der Sitzungsstatusdaten verwendeter Zeichenfolgenwert. Wenn dieses Attribut nicht festgelegt ist, wird der Sitzungsstatus nur für verschiedene physische Instanzen der gleichen Webanwendung gemeinsam verwendet (dabei gilt die zusätzliche Anforderung, dass jede Anwendungsinstanz unter dem gleichen IIS-Metabasispfad installiert ist). Weitere Informationen finden Sie unter https://support.microsoft.com/kb/325056. Wenn dieses Attribut festgelegt ist, wird der Sitzungsstatus von allen Webanwendungen gemeinsam verwendet, die den gleichen Wert applicationName verwenden. |
useBlobMode (optional) |
Ein boolescher Wert, der angibt, ob Sitzungsstatusdaten als einzelner, serialisierter Blob geladen und gespeichert werden. Der Standardwert ist |
nonInlinedAdditionalLifetime (optional) |
Eine Zeitspanne, die der Anbieter verwendet, um den nächsten Zeitpunkt nachzuverfolgen, zu dem ein einzelnes (Nicht-Inline-Element) Sitzungsstatuselement aktualisiert werden muss, damit das Element "aktiv" bleibt. Dieser Wert wird nur verwendet, wenn useBlobMode auf |
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 |
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. |
inlinedKeys (optional) |
Ein Zeichenfolgenwert, der einen durch Kommas oder Semikolons getrennten Satz von Sitzungsstatusschlüsseln enthält, deren Werte im Metadaten-Datensatz des Sitzungsstatus "inline" sein sollten. Diese Einstellung gilt nur, wenn useBlobMode auf |
maxInlinedStringLength (optional) |
Ein ganzzahliger Wert, der die maximale Zeichenfolgengröße für einen Sitzungsstatuswert angibt, der im Metadaten-Datensatz des Sitzungsstatus automatisch als "inline" angegeben wird. Diese Einstellung gilt nur, wenn useBlobMode auf |
Beispiel
Das folgende Beispielelement sessionState verwendet einzelne Schlüssel/Wert-Paare für den Sitzungsstatus sowie einen gemeinsamen Anwendungsnamen.
<sessionState
mode="Custom"
customProvider="DistributedSessionProvider">
<providers>
<add name="DistributedSessionProvider"
type="Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider,
Microsoft.Web.DistributedCache"
cacheName="default"
applicationName="Contoso"
useBlobMode="true" />
</providers>
</sessionState>
Siehe auch
Konzepte
Sitzungsstatusanbieter (AppFabric 1.1-Cache)
2012-03-05