Compartilhar via

roleManager Element (ASP.NET Settings Schema)

  • Artigo

Configura um aplicativo para gerenciamento de função.

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

<roleManager
    cacheRolesInCookie="true|false"
    cookieName="name"
    cookiePath="/"
    cookieProtection="All|Encryption|Validation|None"
    cookieRequireSSL="true|false "
    cookieSlidingExpiration="true|false "
    cookieTimeout="number of minutes"
    createPersistentCookie="true|false"
    defaultProvider="provider name"
    domain="cookie domain">
    enabled="true|false"
    maxCachedResults="maximum number of role names cached"
    <providers>...</providers>
</roleManager>

Atributos e elementos

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

Atributos

Atributo

Descrição

cacheRolesInCookie

Opcional Boolean atributo.

Especifica que, ao validar que um usuário está em uma determinada função, o cookie é verificado antes de usar o provedor de função para verificar a lista de funções na fonte de dados. Se true, uma lista de nomes de função em um cookie é armazenado em cache para o usuário atual; Caso contrário, false.

O padrão é false.

cookieName

Opcional String atributo.

Especifica o nome do cookie no qual os nomes de função são armazenados.

O padrão é ".ASPXROLES".

cookiePath

Opcional String atributo.

O caminho para o cookie de nomes de função.

O padrão é "/".

cookieProtection

Opcional CookieProtection atributo.

Especifica um do CookieProtection valores de enumeração.

O padrão é o All valor.

cookieRequireSSL

Opcional Boolean atributo.

Especifica se o cookie de nomes de função requer SSL para ser a fatura para o servidor.

Se definido como true, os cookies de nomes de função exigem SSL a ser enviado ao servidor.

O padrão é false.

cookieSlidingExpiration

Opcional Boolean atributo.

Especifica se a data de expiração do cookie de nomes de função serão redefinidas periodicamente.

Se definido como true, a expiração de cookies será inicialmente definida como a data e hora atuais, além de CookieTimeout valor, em minutos. Enquanto o usuário continua a usar ativamente o ASP.NET Visual Basic, a data de expiração do cookie é atualizado automaticamente, se houver menos da metade da CookieTimeout valor restante. Para obter mais informações, consulte Expires.

O padrão é true.

cookieTimeout

Opcional Int32 atributo.

O número de minutos antes do cookie de nomes de função expira.

O padrão é "30" (minutos).

createPersistentCookie

Opcional Boolean atributo.

Especifica se o cookie de nomes de função é um cookie de sessão. ou seja, o cookie é perdido quando o navegador é fechado.

Quando definido como true, a função nomes é um cookie persistente que está disponível em várias sessões de navegador. A data de expiração do cookie persistente e a hora estão definidas para a data e hora atuais, além de CookieTimeout valor, em minutos.

O padrão é false.

defaultProvider

Opcional String atributo.

O nome do provedor de função padrão. Para obter mais informações, consulte Provider.

O padrão é "AspNetSqlRoleProvider".

domain

Opcional String atributo.

Especifica o Domain o valor do cookie de nomes de função.

O padrão é o HttpCookie padrão de propriedade, o que é uma seqüência vazia ("").

enabled

Opcional Boolean atributo.

Especifica se deseja ativar o gerenciamento de função.

Quando definido como true, gerenciamento de função está ativado.

O padrão é false no arquivo Machine. config.

maxCachedResults

Opcional Int32 atributo.

Especifica o número máximo de nomes de função são armazenados em cache no cookie funções.

O padrão é 25.

Atributos herdados

Atributos opcionais.

Os atributos herdados por todos os section elementos. Para obter mais informações, consulte Geral Atributos Herdados por elementos de seção.

Elementos filho

Elemento

Descrição

providers

Elemento opcional.

Define uma coleção de provedores de função para o gerenciamento de função.

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.Seção de configuração de rede.

Comentários

O roleManager elemento configura um aplicativo para gerenciamento de função.

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

Configuração padrão

O seguinte padrão roleManager é 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. Os provedores são explicitamente configurados no arquivo Machine. config.

<roleManager 
   enabled="false" 
   cacheRolesInCookie="false" 
   cookieName=".ASPXROLES" 
   cookieTimeout="30" 
   cookiePath="/" 
   cookieRequireSSL="false" 
   cookieSlidingExpiration="true" 
   cookieProtection="All" 
   defaultProvider="AspNetSqlRoleProvider" 
   createPersistentCookie="false" 
   maxCachedResults="25">
   <providers>
      <clear />
      <add 
         connectionStringName="LocalSqlServer" 
         applicationName="/" 
         name="AspNetSqlRoleProvider" 
         type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
      <add 
         applicationName="/" 
         name="AspNetWindowsTokenRoleProvider" 
         type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
   </providers>
</roleManager>

Exemplo

O exemplo de código a seguir mostra como configurar um aplicativo ASP.NET para usar o SqlRoleProvider classe para armazenar e recuperar informações de função.

<configuration>
  <system.web>
    <roleManager defaultProvider="SqlProvider" 
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="false"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices" 
          applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

Informações do elemento

Manipulador da seção de configuração

RoleManagerSection

Membro de configuração

RoleManager

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

system.web Element (ASP.NET Settings Schema)

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

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

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Conceitos

Noções básicas sobre gerenciamento de funções

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

ASP.NET referência

Administração de Sites do ASP.NET

API de Configuração do ASP.NET