ProfileProvider.FindProfilesByUserName メソッド

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollection

Public MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

パラメーター

戻り値

指定された usernameToMatch パラメーターに一致するユーザー名のプロファイルに関するユーザー プロファイル情報を格納している ProfileInfoCollection。

例

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

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

    return new ProfileInfoCollection();
}

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

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

注釈

メソッドは FindProfilesByUserName 、ユーザー名が指定された usernameToMatch パラメーターと一致するプロファイルのプロファイル情報の一覧を返します。 構成ファイルで指定された の applicationName データのみが返されます。 パラメーターは authenticationOption 、匿名プロファイルのみ、認証済みプロファイルのみ、またはすべてのプロファイルを検索するかどうかを指定します。

データ ソースでワイルドカード文字などの追加の検索機能がサポートされている場合は、ユーザー名に対してより広範な検索機能を提供できます。

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

適用対象

こちらもご覧ください

• プロファイル プロバイダーの実装
• ASP.NET プロファイルプロパティの概要