Adicionar elemento para provedores de roleManager (ASP.NET Configurações Schema)
Adiciona uma instância do provedor de função à coleção de provedores de gerenciamento de função.
Esse elemento é novo no .NET Framework versão 2.0.
<add name="provider name"
type="string"
connectionStringName="string"
applicationName="string"
commandTimeout="number"
description="string"
cacheRefreshInterval="number"
scopeName="string"/>
Atributos e elementos
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Atributos
Atributo |
Descrição |
|---|---|
applicationName |
Opcional String atributo. Especifica o nome do aplicativo sob a qual os nomes de função são armazenados na fonte de dados. O nome do aplicativo permite que vários aplicativos ASP.NET usem o mesmo banco de dados sem encontrar nomes de função duplicados para diferentes aplicativos. Como alternativa, vários aplicativos ASP.NET podem usar as mesmas informações de função, especificando o mesmo nome do aplicativo. Os provedores de função incluídos com o.Uso do NET Framework a ApplicationVirtualPath valor para o ApplicationName propriedade, se este atributo não for especificado. |
cacheRefreshInterval |
Opcional Int32 atributo. Especifica o número de minutos entre atualizações forçadas da diretiva em cache de armazenar dados e aplica-se para o AuthorizationStoreRoleProvider somente. O padrão é 60. |
commandTimeout |
Opcional Int32 atributo. Especifica o número de segundos antes que um comando que é emitido para a fonte de dados do Gerenciador de função expira. Esse tempo limite é usada pelo provedor SQL ao criar SqlCommand objetos. Por padrão, esse atributo não está definido no ASP.Configuração de rede. Como resultado do ADO.NET padrão de 30 segundos será usado. Se esse atributo estiver definido, o provedor SQL usa o valor de tempo de limite configurado para todos os comandos SQL que são emitidos para o banco de dados. O padrão é 30 (o ADO.NET padrão). |
connectionStringName |
Obrigatório String atributo. Especifica o nome de uma seqüência de conexão está definido na <connectionStrings> elemento. A seqüência de caracteres de conexão especificada será usada pelo provedor que está sendo adicionado. |
description |
Opcional String atributo. Especifica uma descrição da instância do provedor de função. |
name |
Obrigatório String atributo. Especifica o nome da instância do provedor. Esse é o valor que é usado para o defaultProvider atributo o <roleManager> elemento para identificar a instância do provedor como o provedor de função padrão. O name do provedor também é usado para indexar o provedor de Providers coleção. |
scopeName |
Opcional String atributo. Especifica o escopo de segurança de um armazenamento de diretivas do Gerenciador de autorização que a instância do provedor deve se conectar e aplica-se para o AuthorizationStoreRoleProvider somente. Se scopeName for especificado, a combinação de applicationName e scopeName é usado pelo provedor ao se conectar ao armazenamento de diretiva. |
type |
Obrigatório String atributo. Especifica o tipo que está implementando o RoleProvider abstrata classe de base. |
Elementos filho
Nenhum.
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. |
roleManager |
Configura um aplicativo para gerenciamento de função. |
providers |
Define uma coleção de provedores de função para o gerenciamento de função. |
Comentários
O add elemento adiciona uma instância do provedor de função para a coleção de provedor de gerenciamento de função que é armazenada nas provedores elemento.
O providers elemento define uma coleção de provedores de função para o 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, WindowsTokenRoleProvider, SqlRoleProvider, e AuthorizationStoreRoleProvider.
Configuração padrão
O seguinte padrão providers elemento é configurado no arquivo Machine. config.
<roleManager>
<providers>
<add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add name="AspNetWindowsTokenRoleProvider" applicationName="/" 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 |
|
Membro de configuração |
|
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
provedores de elemento para roleManager (ASP.NET Configurações Schema)
Desmarque o elemento para provedores de roleManager (ASP.NET Configurações Schema)
Remover elemento para provedores de roleManager (ASP.NET Configurações Schema)
roleManager Element (ASP.NET Settings Schema)
system.web Element (ASP.NET Settings Schema)
configuração Element (Geral Configurações Schema)
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