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 Element (ASP.NET Settings Schema).

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

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

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

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

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

Общие сведения о членстве ASP.NET

Поделиться через