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

Articolo
08/11/2011

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

Questo elemento è nuovo in .NET Framework versione 2.0.

<clear/>

Attributi ed elementi

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

Attributi

Nessuno.

Elementi figlio

Nessuno.

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

Note

L'elemento clear rimuove tutti i riferimenti ai provider per l'archivio dello stato sessione ereditati nell'elemento providers, consentendo solo quelli aggiunti dagli elementi add successivi.

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. Nell'esempio viene cancellata qualsiasi istanza di provider dell'archivio per lo stato sessione esistente mediante l'elemento clear prima di aggiungere l'istanza personalizzata del provider dell'archivio per lo stato sessione. Per informazioni sull'implementazione di un provider per l'archivio dello stato sessione e 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>
        <clear />
        <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	Clear 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

Condividi tramite

Elemento clear per 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