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

Artikel
09/03/2008

Aktualisiert: November 2007

Fügt der Auflistung von Sitzungszustandsspeicher-Anbietern einen Anbieter hinzu.

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-Einstellungsschema)
    sessionState-Element (ASP.NET-Einstellungsschema)
      providers-Element für sessionState (ASP.NET-Einstellungsschema)
        add-Element für providers für sessionState (ASP.NET-Einstellungsschema)

<add 
    name="provider name" 
    type="fully qualified type reference"
/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
name	Erforderliches String-Attribut Legt den Namen der Anbieterinstanz fest. Dieser Wert wird für das customProvider-Attribut des sessionState-Elements verwendet, um die Anbieterinstanz als den Sitzungszustandsspeicher-Anbieter zu identifizieren, wenn das Modusattribut des sessionState-Elements auf den Wert Custom festgelegt ist.
type	Erforderliches String-Attribut Gibt den Typ an, der die abstrakte SessionStateStoreProviderBase-Basisklasse implementiert. Der Wert muss ein vollqualifizierter Verweis auf die Assembly sein.

name

Erforderliches String-Attribut

Legt den Namen der Anbieterinstanz fest. Dieser Wert wird für das customProvider-Attribut des sessionState-Elements verwendet, um die Anbieterinstanz als den Sitzungszustandsspeicher-Anbieter zu identifizieren, wenn das Modusattribut des sessionState-Elements auf den Wert Custom festgelegt ist.

type

Erforderliches String-Attribut

Gibt den Typ an, der die abstrakte SessionStateStoreProviderBase-Basisklasse implementiert.

Der Wert muss ein vollqualifizierter Verweis auf die Assembly sein.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das erforderliche Stammelement in jeder Konfigurationsdatei, 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 add-Element fügt der Auflistung von Sitzungszustandsspeicher-Anbietern im providers-Element einen Anbieter hinzu. Das providers-Element enthält eine Auflistung benutzerdefinierter Sitzungszustandsspeicher-Anbieter. Der benutzerdefinierte Sitzungszustandsspeicher-Anbieter muss von der SessionStateStoreProviderBase-Klasse erben.

Informationen zum Zugriff auf Konfigurationswerte und zum Ändern von Konfigurationswerten für das sessionState-Element im Anwendungscode finden Sie unter ProviderSettingsCollection und Providers.

Beispiel

Das folgende Codebeispiel zeigt die Verwendung der Datei Web.config einer ASP.NET-Anwendung, die für die Verwendung eines benutzerdefinierten Sitzungszustandsspeicher-Anbieters konfiguriert ist. 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	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 Microsoft .NET Framework, Version 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen