Freigeben über

ActiveDirectoryMembershipProvider.EnableSearchMethods Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

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 : bool
Public ReadOnly Property EnableSearchMethods As Boolean

Eigenschaftswert

Boolean

true, wenn Suchmethoden verfügbar sind, andernfalls false. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

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.

Gilt für:

Weitere Informationen