FindProfilesByUserName
このメソッドは、指定されたユーザー名のプロファイル情報を取得します。
宣言
// C# public override ProfileInfoCollection FindProfilesByUserName (ProfileAuthenticationOption profileAuthenticationOption, string userName, int pageIndex, int pageSize, out int totalRecords);
パラメータ
-
profileAuthenticationOption
アクティブなプロファイルを見つけるために検索する
Anonymous
、Authenticated
またはAll
プロファイル。 -
userName
照合するユーザー名。
-
pageIndex
結果ページのゼロベース索引。
-
pageSize
結果ページのページ・サイズ。
-
totalRecords
プロファイルの総数。
戻り値
ユーザー名が指定されたユーザー名に一致するユーザー・プロファイルを含むProfileInfoCollection
オブジェクト。
例外
ArgumentException
- 次のいずれかの条件が存在します。
-
userName
パラメータが空の文字列であるか、256文字を超えています。 -
pageSize
パラメータ値が1未満です。 -
pageIndex
パラメータ値が0未満であるか、pageIndex
にpageSize
を乗算した値がInt32.MaxValue
を超えています。
ArgumentNullException
- userName
パラメータがnull参照です。
備考
このメソッドは、構成ファイルのapplicationName
属性で指定されたアプリケーションについて、データ・ソースからプロファイルを取得します。profileAuthenticationOption
パラメータでは、匿名プロファイルのみ、認証されたプロファイルのみ、またはすべてのプロファイルのいずれを検索するかを指定します。OracleProfileProvider
オブジェクトでは、LIKE
キーワードを使用して指定されたuserName
パラメータの一致が検索され、パーセント記号(%
)を使用したワイルドカード文字がサポートされます。
このメソッドから戻される結果は、pageIndex
パラメータとpageSize
パラメータによって制約されます。pageSize
パラメータは、ProfileInfoCollection
オブジェクトで戻すProfileInfo
オブジェクトの数を示します。pageIndex
パラメータは、結果のどのページを戻すかを示します。totalRecords
パラメータは、userName
パラメータに一致する非アクティブなユーザー・プロファイルの総数を表す出力パラメータです。