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 成员资格简介