PersonalizationProvider.FindState 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

파생 클래스에서 재정의된 경우 범위와 특정 쿼리 매개 변수를 기반으로 0개 이상의 PersonalizationStateInfo 파생 개체가 포함된 컬렉션을 반환합니다.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);

abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

매개 변수

scope

PersonalizationScope

쿼리할 개인 설정 정보가 있는 PersonalizationScope입니다. 이 값은 null일 수 없습니다.

query

PersonalizationStateQuery

쿼리가 포함된 PersonalizationStateQuery입니다. 이 값은 null일 수 있습니다.

pageIndex

Int32

쿼리를 시작할 위치입니다.

pageSize

Int32

반환할 레코드 수입니다.

totalRecords

Int32

사용할 수 있는 레코드의 총수입니다.

반환

PersonalizationStateInfoCollection

0개 이상의 PersonalizationStateInfoCollection 파생 개체가 포함된 PersonalizationStateInfo입니다.

설명

이 메서드는 개인 설정 데이터를 쿼리하기 위한 관리 메서드의 추상 정의입니다. 파생 구현은 아래에 설명된 논리를 따라야 합니다.

반환된 항목 집합은 및 pageSize 매개 변수에 의해 pageIndex 제한됩니다. 여기서 pageSize 반환할 레코드 수를 설정하고 반환 pageIndex 할 레코드를 설정합니다. 예를 들어 pageIndex 0과 25 중 은 pageSize 처음 25개 항목을 반환하고 pageIndex , 1과 pageSize 25의 은 26-50을 반환합니다. 사용 가능한 모든 레코드를 검색하려면 를 0으로 설정하고 pageSize 를 로 MaxValue설정합니다pageIndex.

파생 개체는 PersonalizationStateInfo사전순으로 반환되고 해당 값과 Username 속성 값의 Path 조합으로 오름차순으로 정렬됩니다.

이 메서드는 쿼리 와일드카드 문자를 기본 데이터 저장소에 전달합니다. 와일드카드 문자에 대한 지원은 현재 각 공급자가 별표(*), 백분율 기호(%) 또는 밑줄(_)과 같은 문자를 처리하는 방법에 따라 달라집니다.

일반적으로 SQL 규격 데이터 저장소의 경우 속성에서 검색 문자열 텍스트의 시작, 끝 또는 중간에 와일드카드 문자가 표시되는 부분 경로에서 와일드카드 검색을 PathToMatch 수행할 수 있습니다. 예를 들어 "~/vdir"로 시작하는 모든 경로를 찾으려면 속성이 PathToMatch "~/vdir%"로 설정됩니다.

마찬가지로 부분 사용자 이름에 대한 와일드카드 검색은 속성의 텍스트 문자열에 있는 임의의 지점에 와일드카드 문자가 UsernameToMatch 표시될 수 있습니다. 예를 들어 "John"으로 시작하는 모든 사용자 이름을 찾으려면 매개 변수는 UsernameToMatch "John%"와 같습니다.

다음 쿼리 제약 조건이 적용됩니다.

• 만 scope 제공되고 query 가 또는 의 모든 속성 query 이 null 반환되거나 null 기본값인 경우 표시된 scope 매개 변수와 일치하는 모든 레코드가 반환됩니다.

• 속성이 이 PathToMatch 아닌 null경우 반환된 레코드도 값과 일치하는 PathToMatch 경로에 따라 필터링됩니다.

• 속성이 이 UsernameToMatch 아닌 null경우 반환된 레코드는 속성 값과 일치하는 UsernameToMatch 사용자 이름에 따라 필터링됩니다.

• 속성이 UserInactiveSinceDate 와 같지 MaxValue않으면 반환된 레코드도 필터링되어 비활성 사용자와 연결된 레코드만 반환됩니다. 비교에는 속성이 LastActivityDate 속성보다 작거나 같은 레코드가 UserInactiveSinceDate 포함됩니다.

이 메서드는 쿼리 매개 변수 조합의 유효성을 검사하지 않습니다. 예를 들어 코드는 공유 scope 특정 사용자 이름과 연결된 개인 설정 상태 레코드 집합을 요청할 수 있습니다. 사용자 이름은 공유 정보와 연결되지 않으므로 반환된 컬렉션은 비어 있습니다.

비어 있지 않은 컬렉션을 반환할 가능성이 있는 매개 변수 조합은 다음과 같습니다.

• Shared속성과 PathToMatch 함께 scope.

• Userscope , UsernameToMatch및 속성의 PathToMatch모든 값과 UserInactiveSinceDate 결합됩니다.