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パラメータに一致する非アクティブなユーザー・プロファイルの総数を表す出力パラメータです。