ActiveDirectoryMembershipProvider.EnableSearchMethods Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.Security
Сборка:
System.Web.dll

Возвращает значение, указывающее, доступны ли методы ActiveDirectoryMembershipProvider ориентированные на поиск.

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

Значение свойства

Boolean

true, если методы поиска доступны; в противном случае — false. Значение по умолчанию — false.

Исключения

InvalidOperationException

Была предпринята попытка получить доступ к свойству EnableSearchMethods до того, как экземпляр ActiveDirectoryMembershipProvider был инициализирован.

Примеры

В следующем примере кода показана запись Web.config, которая настраивает ActiveDirectoryMembershipProvider экземпляр для поиска на сервере 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>

Комментарии

Так как поиск на сервере Active Directory потенциально является ресурсоемким, EnableSearchMethods свойство позволяет отключить методы, ориентированные ActiveDirectoryMembershipProvider на поиск. Свойство EnableSearchMethods задается в файле конфигурации приложения с помощью enableSearchMethods атрибута элемента membership (ASP.NET Параметры Schema).

EnableSearchMethods Если свойство имеет значениеfalse, доступны следующие методы:

Поставщик использует поиск поддерев, начиная с точки поиска, указанной в строке подключения. Дополнительные сведения о строках подключения см. в ActiveDirectoryMembershipProvider разделе класса.

Мы рекомендуем не включать поиск в рабочих системах, пока не подтвердите, что поисковые запросы, выданные классом ActiveDirectoryMembershipProvider , не оказывают негативного влияния на производительность сервера каталогов. ActiveDirectoryMembershipProvider Так как класс предназначен для веб-среды без отслеживания состояния, он не может использовать оптимизации разбиения на страницы, предоставляемые базовыми System.DirectoryServices API. Это означает, что операции разбиения по страницам во время поиска по большим каталогам очень дороги и их следует избегать. Операции поиска всегда выдаются на сервере каталогов, настроенном в строке подключения, или автоматически выбранный сервер в случае строки подключения, указывающей на домен. Поставщик не использует глобальный каталог для своих методов поиска.

Применяется к

См. также раздел