次の方法で共有

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

ActiveDirectoryMembershipProvider インスタンスが初期化される前に、EnableSearchMethods プロパティにアクセスしようとしました。

例

次のコード例は、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 Settings Schema) 要素のenableSearchMethods属性を使用して、アプリケーションの構成ファイルで設定されます。

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

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

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

適用対象

こちらもご覧ください