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 サーバーの検索を有効にするようにインスタンスを 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 Element (ASP.NET Settings Schema) 要素の属性を使用してenableSearchMethods、アプリケーションの構成ファイルで設定されます。

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

• FindUsersByName

• FindUsersByEmail

• GetAllUsers

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

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

こちらもご覧ください

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