Freigeben über


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

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

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

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

Aufgaben

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

providers-Element 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)

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

sessionState-Element (ASP.NET-Einstellungsschema)

system.web-Element (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