ActiveDirectoryMembershipProvider.EnableSearchMethods Propriedade

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll

Obtém um valor que indica se existem métodos orientados ActiveDirectoryMembershipProvider para pesquisa disponíveis.

public:
 property bool EnableSearchMethods { bool get(); };
public bool EnableSearchMethods { get; }
member this.EnableSearchMethods : bool
Public ReadOnly Property EnableSearchMethods As Boolean

Valor de Propriedade

Boolean

true se existirem métodos de pesquisa disponíveis; caso contrário, false. A predefinição é false.

Exceções

InvalidOperationException

Foi feita uma tentativa de aceder à EnableSearchMethods propriedade antes de a ActiveDirectoryMembershipProvider instância ser inicializada.

Exemplos

O exemplo de código seguinte mostra uma entrada Web.config que configura uma instância ActiveDirectoryMembershipProvider para permitir a pesquisa num servidor 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>

Observações

Como pesquisar num servidor Active Directory pode ser potencialmente intensivo em recursos, a propriedade EnableSearchMethods permite desativar métodos orientados à pesquisa ActiveDirectoryMembershipProvider. A propriedade EnableSearchMethods é definida no ficheiro de configuração da sua aplicação usando o atributo enableSearchMethods do elemento membership (ASP.NET Settings Schema).

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

O fornecedor utiliza uma pesquisa em subárvore que começa no ponto de pesquisa especificado na cadeia de ligação. Consulte o ActiveDirectoryMembershipProvider tópico da aula para mais informações sobre cordas de ligação.

Recomendamos que não ative a pesquisa em sistemas de produção até confirmar que as consultas de pesquisa emitidas pela ActiveDirectoryMembershipProvider classe não afetam negativamente o desempenho do seu servidor de diretórios. Como a ActiveDirectoryMembershipProvider classe foi concebida para um ambiente Web sem estado, não consegue utilizar as otimizações de paginação expostas pelas APIs subjacentes System.DirectoryServices . Isto significa que as operações de paginação durante pesquisas em grandes diretórios são muito dispendiosas e devem ser evitadas. As operações de pesquisa são sempre emitidas contra o servidor de diretório configurado na cadeia de ligação, ou contra um servidor selecionado automaticamente no caso de uma cadeia de ligação apontar para um domínio. O fornecedor não utiliza um catálogo global para os seus métodos de pesquisa.

Aplica-se a

Ver também