ProfileProvider.FindProfilesByUserName 메서드

정의

네임스페이스:

System.Web.Profile

어셈블리:

System.Web.dll

파생 클래스에서 재정의될 때 사용자 이름이 지정된 사용자 이름과 일치하는 프로필에 대한 프로필 정보를 검색합니다.

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

매개 변수

authenticationOption

ProfileAuthenticationOption

ProfileAuthenticationOption 값 중 하나로, 반환되는 프로필이 익명인지, 인증되었는지 또는 두 형식 모두인지를 지정합니다.

usernameToMatch

String

검색할 사용자 이름입니다.

pageIndex

Int32

반환할 결과 페이지의 인덱스입니다.

pageSize

Int32

반환할 결과 페이지의 크기입니다.

totalRecords

Int32

이 메서드가 반환될 때 프로필의 총수가 포함됩니다.

반환

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 에 의해 제한 됩니다 합니다 pageIndex 및 pageSize 매개 변수입니다. 합니다 pageSize 의 최대 수를 식별 하는 매개 변수 ProfileInfo 에서 반환 하는 개체는 ProfileInfoCollection합니다. pageIndex 매개 변수는 0에서 첫 번째 페이지를 식별 하는 위치를 반환 하는 결과 페이지를 식별 합니다. totalRecords 매개 변수는는 out 구성 된 비활성 사용자 프로필의 총 수로 설정 된 매개 변수 applicationName기반으로 합니다 authenticationOption 및 userInactiveSinceDate 매개 변수입니다. 예를 들어 13 명의 사용자가 구성 된 경우 applicationName, 및 pageIndex 값이 1을 pageSize 5는 ProfileInfoCollection 반환 6 번째부터 10 번째까지의 비활성 프로필 반환 포함 됩니다. totalRecords 13 매개 변수를 설정 합니다.

추가 정보

• 프로필 공급자를 구현합니다.
• ASP.NET Profile Properties Overview