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 屬性。

範例

下列程式代碼範例顯示設定實例以啟用搜尋 Active Directory 伺服器的 Web.config 專案 ActiveDirectoryMembershipProvider 。

<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 中使用 成員資格元素的 屬性設定， (ASP.NET Settings Schema) 元素。

EnableSearchMethods當 屬性為 false時，無法使用下列方法：

• FindUsersByName

• FindUsersByEmail

• GetAllUsers

提供者會使用從連接字串中指定的搜尋點開始的子樹搜尋。 ActiveDirectoryMembershipProvider如需連接字串的詳細資訊，請參閱 類別主題。

建議您在生產系統上啟用搜尋，直到您確認 類別發出的 ActiveDirectoryMembershipProvider 搜尋查詢不會對目錄伺服器的效能造成負面影響。 由於 類別 ActiveDirectoryMembershipProvider 是針對無狀態 Web 環境所設計，因此無法使用基礎 System.DirectoryServices API 公開的分頁優化。 這表示搜尋大型目錄期間的分頁作業非常昂貴，因此應該避免。 搜尋作業一律會針對連接字串中所設定的目錄伺服器發出，或在指向網域的連接字串的情況下自動選取的伺服器發出。 提供者不會針對其搜尋方法使用全域編錄。

另請參閱

• ASP.NET 成員資格簡介