ActiveDirectoryMembershipProvider.EnableSearchMethods Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Security
Zestaw:
System.Web.dll

Pobiera wartość wskazującą, czy metody zorientowane na ActiveDirectoryMembershipProvider wyszukiwanie są dostępne.

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

Wartość właściwości

Boolean

true jeśli są dostępne metody wyszukiwania; w przeciwnym razie , false. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Podjęto próbę EnableSearchMethods uzyskania dostępu do właściwości przed zainicjowaniem ActiveDirectoryMembershipProvider wystąpienia.

Przykłady

Poniższy przykład kodu przedstawia wpis Web.config, który konfiguruje ActiveDirectoryMembershipProvider wystąpienie w celu umożliwienia wyszukiwania serwera usługi Active Directory.

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

Uwagi

Ponieważ wyszukiwanie serwera usługi Active Directory jest potencjalnie intensywnie korzystające z zasobów, EnableSearchMethods właściwość umożliwia wyłączenie metod zorientowanych na ActiveDirectoryMembershipProvider wyszukiwanie. Właściwość EnableSearchMethods jest ustawiana w pliku konfiguracji aplikacji przy użyciu enableSearchMethods atrybutu elementu członkostwa (ASP.NET Schemat ustawień).

EnableSearchMethods Gdy właściwość to false, następujące metody są niedostępne:

Dostawca używa wyszukiwania poddrzewa rozpoczynającego się od punktu wyszukiwania określonego w parametrach połączenia. Zobacz temat klasy, ActiveDirectoryMembershipProvider aby uzyskać więcej informacji na temat parametrów połączenia.

Zalecamy, aby nie włączać wyszukiwania w systemach produkcyjnych, dopóki nie potwierdzisz, że zapytania wyszukiwania wydane przez ActiveDirectoryMembershipProvider klasę nie wpływają negatywnie na wydajność serwera katalogów. ActiveDirectoryMembershipProvider Ponieważ klasa jest przeznaczona dla bezstanowego środowiska sieci Web, nie może korzystać z optymalizacji stronicowania uwidocznionych przez bazowe System.DirectoryServices interfejsy API. Oznacza to, że operacje stronicowania podczas wyszukiwania w dużych katalogach są bardzo kosztowne i należy unikać. Operacje wyszukiwania są zawsze wystawiane względem serwera katalogów skonfigurowanego w parametrach połączenia lub automatycznie wybranego serwera w przypadku parametrów połączenia wskazujących domenę. Dostawca nie używa wykazu globalnego dla swoich metod wyszukiwania.

Dotyczy

Zobacz też