ActiveDirectoryMembershipProvider.EnableSearchMethods Propriedade

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Obtém um valor que indica se os métodos ActiveDirectoryMembershipProvider orientados à pesquisa estão disponíveis.

public:
 property bool EnableSearchMethods { bool get(); };

public bool EnableSearchMethods { get; }

member this.EnableSearchMethods : bool

Public ReadOnly Property EnableSearchMethods As Boolean

Valor da propriedade

Boolean

true se os métodos de pesquisa estiverem disponíveis, caso contrário, false. O padrão é false.

Exceções

InvalidOperationException

Uma tentativa de acessar a propriedade EnableSearchMethods foi feita antes da inicialização da instância ActiveDirectoryMembershipProvider.

Exemplos

O exemplo de código a seguir mostra uma entrada de Web.config que configura uma ActiveDirectoryMembershipProvider instância para habilitar a pesquisa de um servidor do Active Directory.

<configuration>  
  <connectionStrings>  
    <add name="ADService" connectionString="LDAP://ldapServer/" />  
  </connectionStrings>  
  <system.web>  
    <membership defaultProvider="AspNetActiveDirectoryMembershipProvider">  
      <providers>  
        <add name="AspNetActiveDirectoryMembershipProvider"   
          type="System.Web.Security.ActiveDirectoryMembershipProvider,   
          System.Web, Version=2.0.3600, Culture=neutral,   
          PublicKeyToken=b03f5f7f11d50a3a"  
          enableSearchMethods="true" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Comentários

Como a pesquisa de um servidor do Active Directory é potencialmente intensiva em recursos, a EnableSearchMethods propriedade permite que você desative os métodos orientados ActiveDirectoryMembershipProvider à pesquisa. A EnableSearchMethods propriedade é definida no arquivo de configuração do aplicativo usando o enableSearchMethods atributo do elemento Elemento de associação (ASP.NET Esquema de Configurações ).

Quando a EnableSearchMethods propriedade é false, os seguintes métodos não estão disponíveis:

• FindUsersByName

• FindUsersByEmail

• GetAllUsers

O provedor usa uma pesquisa de subárvore começando no ponto de pesquisa especificado na cadeia de conexão. Consulte o tópico de ActiveDirectoryMembershipProvider classe para obter mais informações sobre cadeias de conexão.

Recomendamos que você não habilite a pesquisa em sistemas de produção até confirmar que as consultas de pesquisa emitidas pela classe não afetam negativamente o ActiveDirectoryMembershipProvider desempenho do servidor de diretório. Como a ActiveDirectoryMembershipProvider classe foi projetada para um ambiente Web sem estado, não é possível usar as otimizações de paginação expostas pelas APIs subjacentes System.DirectoryServices . Isso significa que as operações de paginação durante pesquisas em diretórios grandes são muito caras e devem ser evitadas. As operações de pesquisa sempre são emitidas no servidor de diretório configurado na cadeia de conexão ou em um servidor selecionado automaticamente no caso de uma cadeia de conexão apontando para um domínio. O provedor não usa um catálogo global para seus métodos de pesquisa.

Confira também

• Introdução à associação de ASP.NET