ActiveDirectoryMembershipProvider.EnableSearchMethods Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob suchorientierte ActiveDirectoryMembershipProvider Methoden verfügbar sind.
public:
property bool EnableSearchMethods { bool get(); };public bool EnableSearchMethods { get; }member this.EnableSearchMethods : boolPublic ReadOnly Property EnableSearchMethods As BooleanEigenschaftswert
truewenn Suchmethoden verfügbar sind; andernfalls . false Der Standardwert lautet false.
Ausnahmen
Es wurde versucht, auf die EnableSearchMethods Eigenschaft zuzugreifen, bevor die ActiveDirectoryMembershipProvider Instanz initialisiert wurde.
Beispiele
Das folgende Codebeispiel zeigt einen Web.config Eintrag, der eine ActiveDirectoryMembershipProvider Instanz konfiguriert, um das Durchsuchen eines Active Directory-Servers zu ermöglichen.
<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>
Hinweise
Da das Durchsuchen eines Active Directory-Servers potenziell ressourcenintensiv ist, können Sie mit der EnableSearchMethods Eigenschaft suchorientierte ActiveDirectoryMembershipProvider Methoden deaktivieren. Die EnableSearchMethods Eigenschaft wird in der Konfigurationsdatei Ihrer Anwendung mithilfe enableSearchMethods des Attributs des Membership-Elements (ASP.NET Settings Schema) festgelegt.
Wenn die EnableSearchMethods Eigenschaft lautet false, sind die folgenden Methoden nicht verfügbar:
Der Anbieter verwendet eine Unterstruktursuche, die an dem in der Verbindungszeichenfolge angegebenen Suchpunkt beginnt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Klassenthema.
Es wird empfohlen, die Suche auf Produktionssystemen erst zu aktivieren, wenn Sie bestätigt haben, dass die von der ActiveDirectoryMembershipProvider Klasse ausgestellten Suchabfragen die Leistung Ihres Verzeichnisservers nicht beeinträchtigen. Da die ActiveDirectoryMembershipProvider Klasse für eine zustandslose Webumgebung konzipiert ist, können die Pagingoptimierungen, die von den zugrunde liegenden System.DirectoryServices APIs verfügbar gemacht werden, nicht verwendet werden. Dies bedeutet, dass Pagingvorgänge bei Suchvorgängen für große Verzeichnisse sehr teuer sind und vermieden werden sollten. Suchvorgänge werden immer für den Verzeichnisserver ausgegeben, der in der Verbindungszeichenfolge konfiguriert ist, oder ein automatisch ausgewählter Server im Fall einer Verbindungszeichenfolge, die auf eine Domäne verweist. Der Anbieter verwendet keinen globalen Katalog für seine Suchmethoden.
