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

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

Elemento configuration (schema delle impostazioni generali)
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento sessionState (schema delle impostazioni ASP.NET)
      Elemento providers per sessionState (schema delle impostazioni ASP.NET)
        Elemento add per providers per sessionState (schema delle impostazioni ASP.NET)

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
name	Attributo String obbligatorio. Specifica il nome dell'istanza del provider. Si tratta del valore utilizzato dall'attributo customProvider dell'elemento sessionState per identificare l'istanza del provider come provider per l'archivio dello stato sessione quando l'attributo mode dell'elemento sessionState è impostato sul valore Custom.
type	Attributo String obbligatorio. Specifica il tipo che implementa la classe base astratta SessionStateStoreProviderBase. Il valore deve essere un riferimento completo all'assembly.

name

Attributo String obbligatorio.

Specifica il nome dell'istanza del provider. Si tratta del valore utilizzato dall'attributo customProvider dell'elemento sessionState per identificare l'istanza del provider come provider per l'archivio dello stato sessione quando l'attributo mode dell'elemento sessionState è impostato sul valore Custom.

type

Attributo String obbligatorio.

Specifica il tipo che implementa la classe base astratta SessionStateStoreProviderBase.

Il valore deve essere un riferimento completo all'assembly.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	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.
providers	Contiene un insieme di provider personalizzati per l'archivio dello stato sessione.

Note

L'elemento add aggiunge un provider all'insieme di provider per l'archivio dello stato sessione nell'elemento providers. 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.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il file Web.config per un'applicazione ASP.NET configurata 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	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 Microsoft .NET Framework versione 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite

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

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive