ActiveDirectoryMembershipProvider.EnableSearchMethods プロパティ

public:
 property bool EnableSearchMethods { bool get(); };

public bool EnableSearchMethods { get; }

member this.EnableSearchMethods : bool

Public ReadOnly Property EnableSearchMethods As Boolean

プロパティ値

検索メソッドを使用できる場合は true。それ以外の場合は false。 既定値は、false です。

例外

例

次のコード例は、Active Directory サーバーの検索を有効にするようにインスタンスを ActiveDirectoryMembershipProvider 構成するWeb.config エントリを示しています。

<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、membership 要素 (ASP.NET 設定スキーマ) 要素の 属性を使用してenableSearchMethods、アプリケーションの構成ファイルで設定されます。

プロパティが EnableSearchMethods の場合、 false次のメソッドは使用できません。

• FindUsersByName

• FindUsersByEmail

• GetAllUsers

プロバイダーは、接続文字列で指定された検索ポイントから始まるサブツリー検索を使用します。 接続文字列の ActiveDirectoryMembershipProvider 詳細については、クラスのトピックを参照してください。

クラスによって ActiveDirectoryMembershipProvider 発行された検索クエリがディレクトリ サーバーのパフォーマンスに悪影響を与えないことを確認するまで、運用システムでの検索を有効にしないことをお勧めします。 ActiveDirectoryMembershipProviderクラスはステートレス Web 環境用に設計されているため、基になる System.DirectoryServices API によって公開されるページングの最適化を使用できません。 つまり、大きなディレクトリに対する検索中のページング操作は非常に高価であり、回避する必要があります。 検索操作は、接続文字列で構成されているディレクトリ サーバー、またはドメインを指す接続文字列の場合は自動的に選択されたサーバーに対して常に発行されます。 プロバイダーは、その検索方法にグローバル カタログを使用しません。

適用対象

こちらもご覧ください

• ASP.NET メンバーシップの概要