Språk

ActiveDirectoryMembershipProvider.EnableSearchMethods Egenskap

Definition

Hämtar ett värde som anger om sökorienterade ActiveDirectoryMembershipProvider metoder är tillgängliga.

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

Egenskapsvärde

trueom sökmetoder är tillgängliga; annars . false Standardvärdet är false.

Undantag

Ett försök att komma åt EnableSearchMethods egenskapen gjordes innan instansen ActiveDirectoryMembershipProvider initierades.

Exempel

I följande kodexempel visas en Web.config post som konfigurerar en ActiveDirectoryMembershipProvider-instans för att aktivera sökning på en služba Active Directory server.

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

Kommentarer

Eftersom det kan vara resurskrävande att söka efter en služba Active Directory server kan egenskapen EnableSearchMethods inaktivera sökorienterade ActiveDirectoryMembershipProvider metoder. Egenskapen EnableSearchMethods anges i programmets konfigurationsfil med attributet enableSearchMethods för elementet membership Element (ASP.NET Settings Schema) element.

När egenskapen EnableSearchMethods är falseär följande metoder inte tillgängliga:

Providern använder en underträdssökning som börjar vid sökpunkten som anges i reťazec pripojenia. Mer information om anslutningssträngar finns i ActiveDirectoryMembershipProvider klassavsnittet.

Vi rekommenderar att du inte aktiverar sökning på produktionssystem förrän du har bekräftat att sökfrågorna som utfärdats av ActiveDirectoryMembershipProvider klassen inte påverkar katalogserverns prestanda negativt. ActiveDirectoryMembershipProvider Eftersom klassen är utformad för en tillståndslös webbmiljö kan den inte använda växlingsoptimeringarna som exponeras av de underliggande System.DirectoryServices API:erna. Det innebär att växlingsåtgärder vid sökningar mot stora kataloger är mycket dyra och bör undvikas. Sökåtgärder utfärdas alltid mot katalogservern som konfigurerats i reťazec pripojenia, eller en automatiskt vald server om en reťazec pripojenia pekar på en domän. Providern använder inte en global katalog för sina sökmetoder.

Gäller för

Se även