Adicionar elemento para provedores de roleManager (ASP.NET Settings esquema)

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.

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

<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 usar o mesmo banco de dados sem encontrar nomes da 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 .NET estrutura usar o ApplicationVirtualPath valor para o ApplicationName propriedade, se esse 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 à AuthorizationStoreRoleProvider somente. O padrão é 60.
commandTimeout	Opcional Int32 atributo. Especifica o número de segundos antes que um comando é emitido para a fonte de dados do Gerenciador de função do tempo limite. Esse time limite é usada pelo provedor de SQL ao criar SqlCommand objetos. Por padrão, esse atributo não é conjunto na configuração do ASP.NET. sistema autônomo resultado, o padrão ADO.NET de 30 segundos será usado. Se este atributo estiver definido, o provedor SQL usa o valor de time limite configurado para todos os comandos SQL que são emitidos para o banco de dados. O padrão é 30 (o padrão do ADO.NET).
connectionStringName	Necessário String atributo. Especifica o nome de uma cadeia de caracteres de conexão definida no <connectionstrings> elemento. A cadeia de conexão especificada será usada pelo provedor que está sendo adicionado.
description	Opcional String atributo. Especifica uma descrição da função de instância do provedor.
name	Necessário String atributo. Especifica o nome da instância do provedor. Esse é o valor é usado para o defaultProvider atributo das <rolemanager> elemento para identificar a instância do provedor sistema autônomo o provedor de função padrão. The name do provedor também é usada para indexar o provedor de Providers coleção.
scopeName	Opcional String atributo. Especifica o escopo de segurança de um armazenamento de diretiva de Gerenciador de autorização a instância do provedor deve se conectar e aplica o AuthorizationStoreRoleProvider somente. If scopeName for especificado, a combinação de applicationName e scopeName é usado pelo provedor na conexão para o armazenamento de diretivas.
type	Necessário String atributo. Especifica o tipo que está implementando o RoleProvider classe base abstrata.

Elementos filho

Nenhum.

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.
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

The add elemento adiciona uma instância do provedor de função à coleção função gerenciamento provedor que é armazenada na provedores elemento.

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

Configuração padrão

O seguinte padrão providers elemento está configurado no arquivo computador.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 de seção de configuração	RoleManagerSection
Configuração de membro	Add
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

Last updated on 2010-08-25

Partilhar via

Adicionar elemento para provedores de roleManager (ASP.NET Settings esquema)

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