roleManager Element (ASP.NET Settings Schema)

Artigo
05/28/2012

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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>

Attributes and Elements

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

Attributes

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 para serem enviados para o 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 reinicializados 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 de 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 for fechado. Quando definido como 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 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ções está ativado. O padrão é false no arquivo Machine. config.
maxCachedResults	Opcional Int32 atributo. Especifica o número máximo de nomes de funções que 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 Atributos gerais, herdada por elementos de seção.

Child Elements

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.

Parent Elements

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.Aplicativos do NET Framework.
system.web	Especifica o elemento raiz para o ASP.Seção de configuração de rede.

Remarks

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

Configuração padrão

O seguinte padrão roleManager elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, ele é 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>

Element Information

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	Serviços de Informações da Internet da Microsoft (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

Compartilhar via

roleManager Element (ASP.NET Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Configuração padrão

Exemplo

Element Information

Consulte também

Tasks

Reference

Concepts

Other Resources

Recursos adicionais