ProfileProvider.FindInactiveProfilesByUserName メソッド

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

ProfileProvider.FindInactiveProfilesByUserName メソッド

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

派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付またはそれ以前であり、指定されたユーザー名と一致するユーザー名のプロファイルに関する、プロファイル情報を取得します。

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

Visual Basic (宣言)

Public MustOverride Function
 FindInactiveProfilesByUserName ( _
    authenticationOption As ProfileAuthenticationOption, _
    usernameToMatch As String, _
    userInactiveSinceDate As DateTime, _
    pageIndex As Integer, _
    pageSize As Integer, _
    <OutAttribute> ByRef totalRecords As
 Integer _
) As ProfileInfoCollection

Visual Basic (使用法)

Dim instance As ProfileProvider
Dim authenticationOption As ProfileAuthenticationOption
Dim usernameToMatch As String
Dim userInactiveSinceDate As DateTime
Dim pageIndex As Integer
Dim pageSize As Integer
Dim totalRecords As Integer
Dim returnValue As ProfileInfoCollection

returnValue = instance.FindInactiveProfilesByUserName(authenticationOption, usernameToMatch,
 userInactiveSinceDate, pageIndex, pageSize, totalRecords)

C#

public abstract ProfileInfoCollection FindInactiveProfilesByUserName
 (
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    DateTime userInactiveSinceDate,
    int pageIndex,
    int pageSize,
    out int totalRecords
)

C++

public:
virtual ProfileInfoCollection^ FindInactiveProfilesByUserName (
    ProfileAuthenticationOption authenticationOption, 
    String^ usernameToMatch, 
    DateTime userInactiveSinceDate, 
    int pageIndex, 
    int pageSize, 
    [OutAttribute] int% totalRecords
) abstract

J#

public abstract ProfileInfoCollection FindInactiveProfilesByUserName
 (
    ProfileAuthenticationOption authenticationOption, 
    String usernameToMatch, 
    DateTime userInactiveSinceDate, 
    int pageIndex, 
    int pageSize, 
    /** @attribute OutAttribute() */ /** @ref */ int totalRecords
)

JScript

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

パラメータ

authenticationOption

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

usernameToMatch

検索するユーザー名。

userInactiveSinceDate

アクティブでないと見なすユーザー プロファイルを識別する DateTime。ユーザー プロファイルの LastActivityDate 値が、この日時またはそれ以前に発生している場合、このプロファイルは無効と見なされます。

pageIndex

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

pageSize

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

totalRecords

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

戻り値
指定された usernameToMatch パラメータとユーザー名が一致していて、無効なプロファイルに関するユーザー プロファイル情報を格納している ProfileInfoCollection。

解説

FindInactiveProfilesByUserName メソッドは、指定された usernameToMatch パラメータとユーザー名が一致しており、使用されていないユーザー プロファイルに関する、プロファイル情報の取得に使用されます。構成ファイルで指定された applicationName のデータだけが返されます。authenticationOption パラメータは、検索対象のプロファイル (匿名のプロファイルのみ、認証済みプロファイルのみ、またはすべてのプロファイル) を指定します。検索されたプロファイルのうち、指定されたuserInactiveSinceDate パラメータ値またはそれ以前の LastActivityDate を持つプロファイルが返されます。

データ ソースがワイルドカード文字などの他の検索機能をサポートしている場合、ユーザー名に対する検索機能を拡張できます。

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

使用例

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

Visual Basic

Public Overrides Function
 FindInactiveProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption,
 _
ByVal usernameToMatch As String,
 _
ByVal userInactiveSinceDate As DateTime, _
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 FindInactiveProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    DateTime userInactiveSinceDate,
    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 プロファイル プロパティ