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
true, wenn Suchmethoden verfügbar sind, andernfalls false. Der Standardwert ist false.
Ausnahmen
Vor Initialisierung der EnableSearchMethods-Instanz wurde versucht, auf die ActiveDirectoryMembershipProvider-Eigenschaft zuzugreifen.
Beispiele
Das folgende Codebeispiel zeigt einen Web.config-Eintrag, der eine ActiveDirectoryMembershipProvider Instanz so konfiguriert, dass die Suche nach einem Active Directory-Server aktiviert wird.
<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 die Suche nach einem Active Directory-Server potenziell ressourcenintensiv ist, können Sie mit der EnableSearchMethods Eigenschaft suchorientierte ActiveDirectoryMembershipProvider Methoden deaktivieren. Die EnableSearchMethods -Eigenschaft wird in der Konfigurationsdatei Ihrer Anwendung mit dem enableSearchMethods Attribut 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 ab dem in der Verbindungszeichenfolge angegebenen Suchpunkt. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Klassenthema.
Es wird empfohlen, die Suche auf Produktionssystemen erst dann zu aktivieren, wenn Sie bestätigt haben, dass sich die von der Klasse ausgegebenen Suchabfragen nicht negativ auf die ActiveDirectoryMembershipProvider Leistung Ihres Verzeichnisservers auswirken. Da die ActiveDirectoryMembershipProvider Klasse für eine zustandslose Webumgebung konzipiert ist, kann sie die Pagingoptimierungen nicht verwenden, die von den zugrunde liegenden System.DirectoryServices APIs verfügbar gemacht werden. Dies bedeutet, dass Pagingvorgänge während der Suche mit großen Verzeichnissen sehr teuer sind und vermieden werden sollten. Suchvorgänge werden immer für den verzeichnisserver ausgegeben, der in der Verbindungszeichenfolge konfiguriert ist, oder für einen automatisch ausgewählten Server, wenn eine Verbindungszeichenfolge auf eine Domäne zeigt. Der Anbieter verwendet keinen globalen Katalog für seine Suchmethoden.
