6.1.5.5 FindInactiveProfilesByUserName

このメソッドは、指定されたユーザー名の非アクティブなプロファイル情報を取得します。

宣言

// C#
public override ProfileInfoCollection FindInactiveProfilesByUserName
   (ProfileAuthenticationOption profileAuthenticationOption, string userName,
   DateTime inactiveSinceDateTime,int pageIndex, int pageSize, 
   out int totalRecords);

パラメータ

  • profileAuthenticationOption

    非アクティブなプロファイルを見つけるために検索するAnonymousAuthenticatedまたはAllプロファイル。

  • userName

    照合するユーザー名。

  • inactiveSinceDateTime

    プロファイルが非アクティブであることを示す中断日時。

  • pageIndex

    結果ページのゼロベース索引。

  • pageSize

    結果ページのページ・サイズ。

  • totalRecords

    プロファイルの総数。

戻り値

ユーザー名が指定されたユーザー名に一致する非アクティブ・ユーザー・プロファイルを含むProfileInfoCollectionオブジェクト。

例外

ArgumentException - 次のいずれかの条件が存在します。

  • userNameパラメータが空の文字列であるか、256文字を超えています。

  • pageSizeパラメータが1未満です。

  • pageIndexパラメータが0未満であるか、pageIndexpageSizeを乗算した値がInt32.MaxValueを超えています。

ArgumentNullException - userNameパラメータがnull参照です。

備考

このメソッドは、構成ファイルのapplicationName属性で指定されたアプリケーションについて、非アクティブなプロファイルをデータ・ソースから取得します。profileAuthenticationOptionパラメータでは、匿名プロファイルのみ、認証されたプロファイルのみ、またはすべてのプロファイルのいずれを検索するかを指定します。OracleProfileProviderオブジェクトでは、LIKEキーワードを使用して指定されたuserNameパラメータの一致が検索され、パーセント記号(%)を使用したワイルドカード文字がサポートされます。このメソッドでは、最後のアクティビティ日時が指定されたinactiveSinceDateTimeパラメータ値またはそれより前であるプロファイルが取得されます。

このメソッドから戻される結果は、pageIndexパラメータとpageSizeパラメータによって制約されます。pageSizeパラメータは、ProfileInfoCollectionオブジェクトで戻すProfileInfoオブジェクトの数を示します。pageIndexパラメータは、結果のどのページを戻すかを示します。totalRecordsパラメータは、userNameパラメータおよびinactiveSinceDateTimeパラメータに一致する非アクティブなユーザー・プロファイルの総数を表す出力パラメータです。