Compartilhar via


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

Adiciona um provedor a coleção de provedores de armazenamento de estado da sessão.

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

Atributos e elementos

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

Atributos

Atributo

Descrição

name

Obrigatório String atributo.

Especifica o nome da instância do provedor. Esse é o valor que é usado para o customProvider atributo da sessionState elemento para identificar a instância do provedor como o provedor de armazenamento de estado da sessão quando o atributo mode da sessionState elemento é definido como o Custom valor.

type

Obrigatório String atributo.

Especifica o tipo que está implementando o SessionStateStoreProviderBase abstrata classe de base.

O valor deve ser uma referência ao assembly totalmente qualificada.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

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 add elemento adiciona a coleção de provedores de armazenamento de estado de sessão em um provedor de provedores elemento. 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.

Exemplo

O exemplo de código a seguir mostra como usar o arquivo Web. config para um aplicativo ASP.NET que está configurado para usar um provedor de armazenamento de estado de sessão personalizado. Para obter informações sobre como implementar um provedor de armazenamento de estado da sessão, incluindo 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>
        <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

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 Microsoft.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)

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