providers-Element für sessionState (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Enthält eine Auflistung benutzerdefinierter Sitzungszustandsspeicher-Anbieter.
Dieses Element ist neu in .NET Framework, Version 2.0.
<providers>
<add
/>
<remove />
<clear/>
</providers>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Keine.
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
Add |
Optionales Element. Fügt der Auflistung von Sitzungszustandsspeicher-Anbietern einen Anbieter hinzu. |
clear |
Optionales Element. Entfernt alle Verweise auf geerbte Sitzungszustandsspeicher-Anbieter bis auf die vom aktuellen add-Element hinzugefügten. |
Remove |
Optionales Element. Entfernt einen Verweis auf einen geerbten Sitzungszustandsspeicher-Anbieter aus der Auflistung. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern. |
sessionState |
Konfiguriert Sitzungszustandseinstellungen für die aktuelle Anwendung. |
Hinweise
Das providers-Element enthält eine Auflistung benutzerdefinierter Sitzungszustandsspeicher-Anbieter. Der benutzerdefinierte Sitzungszustandsspeicher-Anbieter muss von der SessionStateStoreProviderBase-Klasse erben.
Informationen darüber, wie Sie im Anwendungscode auf Konfigurationswerte für das sessionState-Element zugreifen und diese ändern können, finden Sie unter ProviderSettingsCollection und Providers.
Standardkonfiguration
Das folgende providers-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert. Es ist jedoch die Standardkonfiguration, die von der Anwendung zurückgegeben wird.
<sessionState
<!-- Attribute settings. -->
>
<providers>
<clear />
</providers>
</sessionState>
Beispiel
Das folgende Codebeispiel zeigt, wie die Datei Web.config einer ASP.NET-Anwendung für die Verwendung eines benutzerdefinierten Sitzungszustandsspeicher-Anbieters konfiguriert wird. Informationen zum Implementieren benutzerdefinierter Sitzungszustandsspeicher-Anbieter einschließlich eines Beispielanbieters finden Sie unter Implementing a Session State Store Provider.
<configuration>
<connectionStrings>
<add name="OdbcSessionServices" connectionString="DSN=SessionState;" />
</connectionStrings>
<system.web>
<sessionState
cookieless="true"
regenerateExpiredSessionId="true"
mode="Custom"
customProvider="OdbcSessionProvider">
<providers>
<add name="OdbcSessionProvider"
type="Samples.AspNet.Session.OdbcSessionStateStore"
connectionStringName="OdbcSessionServices"
writeExceptionsToEventLog="false" />
</providers>
</sessionState>
</system.web>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005 |
Siehe auch
Aufgaben
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Referenz
sessionState-Element (ASP.NET-Einstellungsschema)
add-Element für Anbieter für sessionState (ASP.NET-Einstellungsschema)
clear-Element für Anbieter für sessionState (ASP.NET-Einstellungsschema)
remove-Element für Anbieter für sessionState (ASP.NET-Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
providers-Element für sessionState (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
Konzepte
Implementing a Session-State Store Provider
ASP.NET Configuration File Hierarchy
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen