ProfileProvider.GetAllProfiles メソッド

.NET Framework クラス ライブラリ リファレンス

ProfileProvider.GetAllProfiles メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

派生クラスでオーバーライドされた場合、データ ソース内のすべてのプロファイルに関するユーザー プロファイル データを取得します。

名前空間: System.Web.Profile
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 GetAllProfiles ( _
    authenticationOption As ProfileAuthenticationOption, _
    pageIndex As Integer, _
    pageSize As Integer, _
    <OutAttribute> ByRef totalRecords As
 Integer _
) As ProfileInfoCollection

Visual Basic (使用法)

Dim instance As ProfileProvider
Dim authenticationOption As ProfileAuthenticationOption
Dim pageIndex As Integer
Dim pageSize As Integer
Dim totalRecords As Integer
Dim returnValue As ProfileInfoCollection

returnValue = instance.GetAllProfiles(authenticationOption, pageIndex, pageSize,
 totalRecords)

C#

public abstract ProfileInfoCollection GetAllProfiles (
    ProfileAuthenticationOption authenticationOption,
    int pageIndex,
    int pageSize,
    out int totalRecords
)

C++

public:
virtual ProfileInfoCollection^ GetAllProfiles (
    ProfileAuthenticationOption authenticationOption, 
    int pageIndex, 
    int pageSize, 
    [OutAttribute] int% totalRecords
) abstract

J#

public abstract ProfileInfoCollection GetAllProfiles (
    ProfileAuthenticationOption authenticationOption, 
    int pageIndex, 
    int pageSize, 
    /** @attribute OutAttribute() */ /** @ref */ int totalRecords
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

authenticationOption

プロファイルの種類 (匿名、認証、またはその両方) を指定する ProfileAuthenticationOption 値の 1 つが返されます。

pageIndex

取得する結果のページのインデックス。

pageSize

取得する結果のページのサイズ。

totalRecords

このメソッドが返されるときに、プロファイルの総数を格納します。

戻り値
データ ソース内のすべてのプロファイルに関するユーザー プロファイル情報を格納している ProfileInfoCollection。

解説

GetAllProfiles メソッドは、すべてのプロファイルに関するプロファイル情報の取得に使用されます。構成ファイルで指定された applicationName のデータだけが返されます。authenticationOption パラメータは、検索対象のプロファイル (匿名のプロファイルのみ、認証済みプロファイルのみ、またはすべてのプロファイル) を指定します。

GetAllInactiveProfiles によって返される結果は、pageIndex パラメータおよび pageSize パラメータによって制限されます。pageSize パラメータには、ProfileInfoCollection で返す ProfileInfo オブジェクトの最大数を指定します。pageIndex パラメータは、取得する結果のページを識別します。最初のページは 0 で表されます。totalRecords パラメータは、authenticationOption パラメータと userInactiveSinceDate パラメータに基づいて、構成済みの applicationName に対してアクティブでないユーザー プロファイルの合計数に設定された out パラメータです。たとえば、構成済みの applicationName に 13 人のユーザーが存在し、pageIndex 値が 1 で pageSize が 5 である場合、ProfileInfoCollection の戻り値には 6 番目から 10 番目までのアクティブでないプロファイルが含まれます。totalRecords パラメータは、13 に設定されます。

使用例

GetAllProfiles メソッドを実装するために必要なメソッド シグネチャを次のコード例に示します。ProfileProvider の完全な実装例については、「方法 : プロファイル プロバイダの構築と実行の例」を参照してください。

Visual Basic

Public Overrides Function
 GetAllProfiles( _
ByVal authenticationOption As ProfileAuthenticationOption,
 _
ByVal pageIndex As Integer,
 _
ByVal pageSize As Integer,
 _
 ByRef totalRecords As Integer)
 As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

C#

public override ProfileInfoCollection GetAllProfiles(
    ProfileAuthenticationOption authenticationOption,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ProfileProvider クラス
ProfileProvider メンバ
System.Web.Profile 名前空間
その他の技術情報
プロファイル プロバイダの実装
ASP.NET プロファイル プロパティ