ActiveDirectoryMembershipProvider.EnableSearchMethods 属性

定义

获取一个值,该值指示面向搜索的 ActiveDirectoryMembershipProvider 方法是否可用。

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

属性值

如果搜索方法可用,则为 true;否则为 false。 默认值为 false

例外

在初始化 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 是使用 enableSearchMethodsmembership Element (ASP.NET Settings Schema) 元素的 属性在应用程序的配置文件中设置的。

EnableSearchMethods 属性为 false时,以下方法不可用:

提供程序使用从连接字符串中指定的搜索点开始的子树搜索。 有关连接字符串的详细信息, ActiveDirectoryMembershipProvider 请参阅类主题。

建议在确认 类发出的 ActiveDirectoryMembershipProvider 搜索查询不会对目录服务器的性能产生负面影响之前,不要在生产系统上启用搜索。 ActiveDirectoryMembershipProvider由于 类专为无状态 Web 环境设计,因此它无法使用基础 System.DirectoryServices API 公开的分页优化。 这意味着,在搜索大型目录期间执行分页操作的成本很高,应避免这样做。 搜索操作始终针对连接字符串中配置的目录服务器,或者在连接字符串指向域的情况下自动选择的服务器发出搜索操作。 提供程序不对其搜索方法使用全局编录。

适用于

另请参阅