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

Artikel
09/03/2008

Aktualisiert: November 2007

Entfernt alle Verweise auf geerbte Sitzungszustandsspeicher-Anbieter bis auf die vom aktuellen add-Element hinzugefügten.

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)
        clear-Element für providers für sessionState (ASP.NET-Einstellungsschema)

<clear/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Keine.

Untergeordnete Elemente

Keine.

Ü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.
providers	Enthält eine Auflistung benutzerdefinierter Sitzungszustandsspeicher-Anbieter.

Hinweise

Das clear-Element entfernt alle im providers-Element enthaltenen Verweise auf geerbte Sitzungszustandsspeicher-Anbieter bis auf die durch nachfolgende add-Elemente hinzugefügten Verweise.

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. Im Beispiel werden mithilfe des clear-Elements alle vorhandenen Instanzen von Sitzungszustandsspeicher-Anbietern gelöscht, bevor die benutzerdefinierte Instanz des Sitzungszustandsspeicher-Anbieters hinzugefügt wird. Informationen zum Implementieren benutzerdefinierter Sitzungszustandsspeicher-Anbieter und einen Beispielanbieter 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>
        <clear />
        <add name="OdbcSessionProvider"
          type="Samples.AspNet.Session.OdbcSessionStateStore"
          connectionStringName="OdbcSessionServices" 
          writeExceptionsToEventLog="false" />
      </providers>
    </sessionState>
  </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	SessionStateSection
Konfigurationsmember	Clear 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

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen