Podelement providers elementu sessionState (schéma nastavení ASP.NET)

Článek
08/11/2011

Obsahuje kolekci poskytovatelů ukládání vlastních stavů relace.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

<providers>
   <add 
      
      
      
      
   />
   <remove />
   <clear/>
</providers>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Žádný

Podřízené prvky

Prvek	Popis
Add	Volitelný prvek. Přidá poskytovatele do kolekce poskytovatelů ukládání stavu relace.
clear	Volitelný element. Odebere všechny odkazy na zděděné zprostředkovatele ukládání stavů relace s tím, že povolí pouze zprostředkovatele přidané aktuálním elementem add.
Remove	Volitelný element. Odebere z kolekce odkaz na zděděného poskytovatele ukládání stavu relace.

Add

Volitelný prvek.

Přidá poskytovatele do kolekce poskytovatelů ukládání stavu relace.

clear

Volitelný element.

Odebere všechny odkazy na zděděné zprostředkovatele ukládání stavů relace s tím, že povolí pouze zprostředkovatele přidané aktuálním elementem add.

Remove

Volitelný element.

Odebere z kolekce odkaz na zděděného poskytovatele ukládání stavu relace.

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.
sessionState	Konfiguruje nastavení stavu relace pro aktuální aplikaci.

Poznámky

Element providers obsahuje kolekci vlastních zprostředkovatelů ukládání stavu relace. Vlastní poskytovatel ukládání stavu relace musí dědit z třídy SessionStateStoreProviderBase.

Informace o přístupu a změnách hodnot konfigurace elementu sessionState z kódu aplikace naleznete v ProviderSettingsCollection a Providers.

Výchozí konfigurace

Následující výchozí element providers není explicitně nakonfigurován v souboru Machine.config nebo v kořenovém souboru web.config. To je však výchozí konfigurace, kterou vrací aplikace.

<sessionState
   <!-- Attribute settings. -->
>
   <providers>
      <clear />
   </providers>
</sessionState>

Příklad

Následující příklad kódu ukazuje, jak nastavit soubor Web.config aplikací technologie ASP.NET pro použití vlastního poskytovatele ukládání stavu relace. Informace o implementaci poskytovatelů ukládání stavu relace včetně ukázkového poskytovatele naleznete v tématu Implementace poskytovatele úložiště stavu relace.

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

Informace prvku

Obslužná rutina konfiguračního oddílu	SessionStateSection
Konfigurační člen	ProviderSettingsCollection Providers
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím

Podelement providers elementu sessionState (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály