ActiveDirectoryMembershipProvider.EnableSearchMethods Eigenschap

Definitie

Naamruimte:
System.Web.Security
Assembly:
System.Web.dll

Hiermee wordt een waarde opgehaald die aangeeft of zoekgeoriënteerde ActiveDirectoryMembershipProvider methoden beschikbaar zijn.

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

Waarde van eigenschap

Boolean

true indien zoekmethoden beschikbaar zijn; anders, false. De standaardwaarde is false.

Uitzonderingen

InvalidOperationException

Er is een poging gedaan om toegang te krijgen tot de EnableSearchMethods eigenschap voordat het ActiveDirectoryMembershipProvider exemplaar werd geïnitialiseerd.

Voorbeelden

In het volgende codevoorbeeld ziet u een Web.config vermelding waarmee een ActiveDirectoryMembershipProvider-exemplaar wordt geconfigureerd om het zoeken naar een Active Directory-server mogelijk te maken.

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

Opmerkingen

Omdat het zoeken naar een Active Directory-server mogelijk resource-intensief is, kunt u met de eigenschap EnableSearchMethods zoekgeoriënteerde ActiveDirectoryMembershipProvider uitschakelen. De eigenschap EnableSearchMethods is ingesteld in het configuratiebestand van uw toepassing met behulp van het kenmerk enableSearchMethods van het element lidship (ASP.NET Settings Schema) element.

Wanneer de EnableSearchMethods eigenschap is false, zijn de volgende methoden niet beschikbaar:

De provider gebruikt een substructuurzoekopdracht die begint bij het zoekpunt dat is opgegeven in de verbindingsreeks. Zie het ActiveDirectoryMembershipProvider klasonderwerp voor meer informatie over verbindingsreeksen.

U wordt aangeraden geen zoekopdrachten in te schakelen op productiesystemen totdat u hebt bevestigd dat de zoekquery's die door de ActiveDirectoryMembershipProvider klasse zijn uitgegeven, geen negatieve invloed hebben op de prestaties van uw adreslijstserver. Omdat de ActiveDirectoryMembershipProvider klasse is ontworpen voor een staatloze webomgeving, kan deze de pagineringsoptimalisaties die worden weergegeven door de onderliggende System.DirectoryServices API's niet gebruiken. Dit betekent dat pagingbewerkingen tijdens zoekopdrachten in grote mappen erg duur zijn en moeten worden vermeden. Zoekbewerkingen worden altijd uitgevoerd op basis van de adreslijstserver die is geconfigureerd in de verbindingsreeks of een automatisch geselecteerde server in het geval van een verbindingsreeks die naar een domein wijst. De provider gebruikt geen globale catalogus voor de zoekmethoden.

Van toepassing op

Zie ook