Elemento providers per sessionState (schema delle impostazioni ASP.NET)

Articolo
08/11/2011

Contiene un insieme di provider personalizzati per l'archivio dello stato sessione.

Questo elemento è nuovo in .NET Framework versione 2.0.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
Add	Elemento facoltativo. Aggiunge un provider all'insieme di provider per l'archivio dello stato sessione.
clear	Elemento facoltativo. Rimuove tutti i riferimenti ai provider per l'archivio dello stato sessione ereditati consentendo solo quelli aggiunti dall'elemento add corrente.
Remove	Elemento facoltativo. Rimuove dall'insieme un riferimento a un provider per l'archivio dello stato sessione ereditato.

Add

Elemento facoltativo.

Aggiunge un provider all'insieme di provider per l'archivio dello stato sessione.

clear

Elemento facoltativo.

Rimuove tutti i riferimenti ai provider per l'archivio dello stato sessione ereditati consentendo solo quelli aggiunti dall'elemento add corrente.

Remove

Elemento facoltativo.

Rimuove dall'insieme un riferimento a un provider per l'archivio dello stato sessione ereditato.

Elementi padre

Elemento	Descrizione
configuration	Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento.
sessionState	Configura le impostazioni dello stato sessione per l'applicazione corrente.

Note

L'elemento providers contiene un insieme di provider personalizzati per l'archivio dello stato sessione. ll provider personalizzato per l'archivio dello stato sessione deve ereditare dalla classe SessionStateStoreProviderBase.

Per informazioni su come accedere ai valori di configurazione per l'elemento sessionState e modificarli nel codice dell'applicazione, vedere ProviderSettingsCollection e Providers.

Configurazione predefinita

L'elemento providers predefinito riportato di seguito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config radice. Si tratta, tuttavia, della configurazione predefinita restituita dall'applicazione.

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

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come configurare il file Web.config per un'applicazione ASP.NET per l'utilizzo di un provider personalizzato per l'archivio dello stato sessione. Per informazioni sull'implementazione di un provider per l'archivio dello stato sessione che includa un provider di esempio, vedere Implementazione di un provider dell'archivio dello stato sessione.

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

Informazioni sull'elemento

Gestore della sezione di configurazione	SessionStateSection
Membro di configurazione	ProviderSettingsCollection Providers
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Elemento providers per sessionState (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive