次の方法で共有

ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) メソッド

定義

名前空間:
System.Web.Security
アセンブリ:
System.Web.dll

Active Directory データ ソースに格納されているすべてのユーザーのコレクションを取得します。

public:
 override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public override System.Web.Security.MembershipUserCollection GetAllUsers(int pageIndex, int pageSize, out int totalRecords);
override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollection
Public Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

パラメーター

pageIndex
Int32

返される結果のページのインデックス。 pageIndex は 0 から始まります。

pageSize
Int32

返される結果のページのサイズ。

totalRecords
Int32

このメソッドから制御が戻るときに、コレクションに返されたレコードの合計数が格納されます。 このパラメーターは初期化せずに渡されます。

戻り値

MembershipUserCollection

pageIndexによって指定されたページから始まるpageSizeMembershipUserインスタンスを含むMembershipUserCollection。

例外

InvalidOperationException

ActiveDirectoryMembershipProvider インスタンスが初期化される前に、GetAllUsers(Int32, Int32, Int32) メソッドが呼び出されます。

ArgumentException

pageIndex が 0 未満です。

-または

pageSize が 1 未満です。

-又は-

pageSize pageIndexを乗算し、pageSizeを加算し、1 を引いた値が Int32.MaxValue より大きい。

NotSupportedException

EnableSearchMethods プロパティはfalse。

注釈

このメソッドは、ASP.NET アプリケーションの構成ファイルで指定された Active Directory データ ストアからユーザー情報を取得するために、 Membership クラスによって呼び出されます。

GetAllUsers メソッドによって返される結果は、pageIndexパラメーターとpageSize パラメーターによって制限されます。 pageSize パラメーターは、MembershipUserCollection コレクションで返されるMembershipUser インスタンスの最大数を指定します。 pageIndex パラメーターは、返す結果のページを指定します。0 (ゼロ) は最初のページを示します。

totalRecords パラメーターは、Active Directory データ ストアで見つかった一致するメンバーシップ ユーザーの合計数に設定されるout パラメーターです。 たとえば、構成されたデータ ストアに 13 人のユーザーがいて、 pageIndex 値が 1 で la pageSize が 5 の場合、返される MembershipUserCollection には 6 番目から 10 番目のユーザーが含まれます。 totalRecords パラメーターは 13 に設定されます。

membership Element (ASP.NET Settings Schema) 要素のenableSearchMethods属性を使用して、アプリケーションの構成ファイルのEnableSearchMethods プロパティを設定することで、ユーザーの検索を許可するかどうかを制御できます。 EnableSearchMethods プロパティを false に設定すると、GetAllUsers メソッドはNotSupportedException例外をスローします。

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

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

適用対象

こちらもご覧ください