roleManager elemento (esquema configurações ASP.NET)

Artigo
08/25/2010

Configura um aplicativo para gerenciamento de função.

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

configuração elemento (Geral Settings esquema)
System.Web elemento (esquema configurações ASP.NET)
roleManager elemento (esquema configurações ASP.NET)

<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 e elementos filho elementos pai para esta seção.

Atributos

Atributo	Descrição
cacheRolesInCookie	Opcional Boolean atributo. Especifica que, ao validar que um usuário estiver em uma determinada função, o cookie está selecionado antes de usar o provedor de função para verificar a lista de funções na fonte de dados. If true, uma lista de nomes de função em um cookie é armazenada em cache para o usuário corrente; caso contrário, false. O padrão é false.
cookieName	Opcional String atributo. Especifica o nome do cookie no qual os nomes de funções 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 o 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 setn ao servidor. If conjunto to true, cookies de nomes de função exigem o SSL seja enviado ao servidor. O padrão é false.
cookieSlidingExpiration	Opcional Boolean atributo. Especifica se a data e time de expiração do cookie de nomes de função serão reinicializados periodicamente. If conjunto to true, a expiração de cookies primeiro será conjunto à data atual e time mais o CookieTimeout valor em minutos. Embora o usuário continue a usar ativamente o aplicativo ASP.NET, a data e time de expiração do cookie é atualizada automaticamente, se houver menos de metade do 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 a função de nomes de cookie é um cookie de sessão; ou seja, o cookie é perdido quando o navegador for fechado. Quando conjunto para true, o cookie de nomes de função é um cookie persistente que está disponível em várias sessões do navegador. A data de expiração de cookies persistentes e a time estão conjunto como a data corrente e time mais o 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 valor do cookie de nomes de função. O padrão é o HttpCookiepropriedade padrão, que é uma seqüência de caracteres vazia ("").
enabled	Opcional Boolean atributo. Especifica se deve permitir o gerenciamento de função. Quando conjunto para true, o gerenciamento de função está ativado. O padrão é false in the computador. arquivo de configuração.
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. Atributos herdados por todos os section elementos. Para obter mais informações, consulte Atributos Geral 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.

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 exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.
system.web	Especifica o elemento raiz referente à seção de configuração do ASP.NET.

Comentários

The 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 elemento de código do aplicativo, consulte RoleManagerSection.

Configuração padrão

O seguinte padrão roleManager elemento não está configurado explicitamente na computador. arquivo de configuração ou na Web raiz. arquivo de configuração. No entanto, é a configuração padrão que é retornada pelo aplicativo. Os provedores são configurados explicitamente o arquivo computador.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 de seção de configuração	RoleManagerSection
Configuração de membro	RoleManager
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 O .NET estrutura versão 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

roleManager elemento (esquema configurações ASP.NET)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais