providers-Element für sessionState (ASP.NET-Einstellungsschema)
Aktualisiert: November 2007
Enthält eine Auflistung benutzerdefinierter Sitzungszustandsspeicher-Anbieter.
Dieses Element ist neu in .NET Framework, Version 2.0.
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
sessionState-Element (ASP.NET-Einstellungsschema)
providers-Element für sessionState (ASP.NET-Einstellungsschema)
<providers>
<add
/>
<remove />
<clear/>
</providers>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente 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 Sitzungszustandsspeicher-Anbieter. |
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 Implementieren eines Sitzungszustandsspeicher-Anbieters.
<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
Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen
Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen
Konzepte
Implementieren eines Sitzungszustandsspeicher-Anbieters
ASP.NET-Konfigurationsdateihierarchie und Vererbung
Absichern der ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Referenz
sessionState-Element (ASP.NET-Einstellungsschema)
add-Element für providers für sessionState (ASP.NET-Einstellungsschema)
clear-Element für providers für sessionState (ASP.NET-Einstellungsschema)
remove-Element für providers für sessionState (ASP.NET-Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
providers-Element für sessionState (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
Weitere Ressourcen
Verschlüsseln von Konfigurationsinformationen mithilfe der geschützten Konfiguration
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen