Freigeben über


providers-Element für sessionState (ASP.NET-Einstellungsschema)

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, 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

SessionStateSection

Konfigurationsmember

ProviderSettingsCollection

Providers

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

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)

System.Configuration

System.Web.Configuration

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

Konzepte

Implementieren eines Sitzungszustandsspeicher-Anbieters

Sichern des Sitzungszustands

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

Verschlüsseln von Konfigurationsinformationen mithilfe der geschützten Konfiguration

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Websiteverwaltung

ASP.NET-Konfigurations-API