Partilhar via


Desmarque o elemento para provedores de sessionState (ASP.NET Configurações Schema)

Remove todas as referências ao estado de sessão herdada armazenam provedores, permitindo que somente os provedores de armazenamento de estado de sessão são adicionados pelo atual Adicionar elemento.

Esse elemento é novo no .NET Framework versão 2.0.

<clear/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Nenhum.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

system.web

Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

sessionState

Configura definições de estado de sessão para o aplicativo atual.

providers

Contém uma coleção de provedores de armazenamento de estado de sessão personalizado.

Comentários

O clear elemento remove todas as referências a provedores de armazenamento de estado da sessão herdadas do provedores elemento, permitindo que somente o estado de sessão armazena provedores que são adicionadas pelo sucesso Adicionar elementos.

O providers elemento contém uma coleção de provedores de armazenamento de estado de sessão personalizado. Provedor de armazenamento de estado de sessão personalizado deve herdar a partir de SessionStateStoreProviderBase classe.

Para obter informações sobre como acessar e modificar valores de configuração para o sessionState o elemento no código do aplicativo, consulte ProviderSettingsCollection e Providers.

Configuração padrão

O seguinte padrão providers é o elemento não explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, é a configuração padrão que é retornada pelo aplicativo.

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

Exemplo

O exemplo de código a seguir mostra como configurar o arquivo Web. config para um aplicativo ASP.NET para usar um provedor de armazenamento de estado de sessão personalizado. O exemplo limpa todas as instâncias existentes de provedores de armazenamento de estado de sessão usando o Limpar elemento, antes de adicionar a instância do provedor de armazenamento de estado de sessão personalizada. Para obter informações sobre como implementar um provedor de armazenamento de estado da sessão e um provedor de exemplo, consulte Implementar um Provedor de Armazenamento de Estado da Sessão.

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

Informações do elemento

Manipulador da seção de configuração

SessionStateSection

Membro de configuração

Clear

Providers

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Requisitos

De da (IIS) versão 5.0, 5.1 ou 6.0

A.NET Framework versão 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tarefas

Como: Configurar Diretórios Específicos Usando Configurações por Localização

Como: Bloquear definições de configuração ASP.NET

Referência

provedores de elemento para sessionState (ASP.NET Configurações Schema)

Adicionar elemento para provedores de sessionState (ASP.NET Configurações Schema)

Remover elemento para provedores de sessionState (ASP.NET Configurações Schema)

provedores de elemento para sessionState (ASP.NET Configurações Schema)

sessionState Element (ASP.NET Settings Schema)

system.web Element (ASP.NET Settings Schema)

configuração Element (Geral Configurações Schema)

System.Configuration

System.Web.Configuration

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

Conceitos

Implementar um Provedor de Armazenamento de Estado da Sessão

Protegendo estado da sessão

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Criptografando informações de configuração usando configuração protegida

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Administração de Sites do ASP.NET

API de Configuração do ASP.NET