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

Aggiornamento: novembre 2007

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.

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 clear per providers per sessionState (schema delle impostazioni ASP.NET)

<clear/>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi 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 principale. 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

Attività

Procedura: configurare directory specifiche utilizzando le impostazioni posizione

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Implementazione di un provider dell'archivio dello stato sessione

Protezione dello stato sessione

Gerarchia ed ereditarietà dei file di configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

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

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

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

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

Elemento sessionState (schema delle impostazioni ASP.NET)

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

System.Configuration

System.Web.Configuration

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

Altre risorse

Crittografia delle informazioni di configurazione utilizzando la configurazione protetta

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

API di configurazione di ASP.NET