roleManager Element (ASP.NET Settings Schema)

Artigo
08/04/2011

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.

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

roleManager Element (ASP.NET Settings Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais