다음을 통해 공유


MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) 메서드

정의

사용자 이름이 지정한 사용자 이름과 일치하는 멤버 자격 사용자의 컬렉션을 가져옵니다.

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

매개 변수

usernameToMatch
String

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

pageIndex
Int32

반환할 결과 페이지의 인덱스입니다. pageIndex는 0부터 시작합니다.

pageSize
Int32

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

totalRecords
Int32

일치하는 총 사용자 수입니다.

반환

pageSize에서 지정한 페이지부터 시작하는 pageIndexMembershipUserCollection 개체의 페이지가 포함된 MembershipUser 컬렉션입니다.

예제

구현의 예제는 MembershipProvider프로필 공급자 구현을 참조하세요.

설명

FindUsersByName는 사용자 이름이 구성된 ApplicationName 속성에 대해 제공된 usernameToMatch 사용자와 일치하는 멤버 자격 사용자 목록을 반환합니다. 데이터 원본에는 와일드 카드 문자 등의 추가 검색 기능을 지 원하는 경우에 사용자 이름에 대 한 보다 광범위 한 검색 기능을 제공할 수 있습니다.

반환한 결과 FindUsersByName 에 의해 제한 됩니다 합니다 pageIndexpageSize 매개 변수입니다. 매개 변수는 pageSize 컬렉션에서 MembershipUserCollection 반환할 개체의 MembershipUser 수를 식별합니다. 매개 변수는 pageIndex 반환할 결과의 페이지를 식별합니다. 여기서 0은 첫 번째 페이지를 식별합니다. totalRecords 매개 변수는 out 값과 일치하는 usernameToMatch 총 멤버 자격 사용자 수로 설정된 매개 변수입니다. 예를 들어 13명의 사용자가 의 일부 또는 전체 사용자 이름과 일치하는 위치를 usernameToMatch 찾았고 pageIndex 값이 5인 1인 경우 반환된 6번째부터 10 pageSize 번째까지의 MembershipUserCollection 사용자가 포함됩니다. totalRecords 는 13으로 설정됩니다.

적용 대상

추가 정보