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

当 EnableSearchMethods 属性为 false时，以下方法不可用：

• FindUsersByName

• FindUsersByEmail

• GetAllUsers

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

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

另请参阅

• ASP.NET 成员资格简介