SqlPersonalizationProvider.FindState 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

지정된 매개 변수를 기반으로 PersonalizationStateInfo 파생 개체가 0개 이상 포함된 컬렉션을 반환합니다.

public:
 override 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 override 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);

override this.FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Overrides 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입니다.

예외

ArgumentException

pageIndex가 0보다 작은 경우

또는

pageSize가 0보다 작거나 같습니다.

또는

및 pageSize 의 pageIndex 조합은 Int32.MaxValue보다 큰 값을 생성합니다.

또는

PathToMatch가 null이 아니고 트리밍 후 빈 문자열("")인 경우

또는

값이 null이 아니고 PathToMatch의 길이가 256자보다 긴 경우

또는

UsernameToMatch가 null이 아니고 트리밍 후 빈 문자열인 경우

또는

값이 null이 아니고 UsernameToMatch의 길이가 256자보다 긴 경우

ArgumentOutOfRangeException

지정한 scope가 PersonalizationScope 열거형의 유효한 값이 아닌 경우

설명

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

파생된 개체는 PersonalizationStateInfo모두 오름차순으로 및 Username로 정렬된 Path 사전순으로 반환됩니다.

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

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

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

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

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

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

• 속성이 UsernameToMatch 이 아닌 null경우 반환된 레코드도 속성 값과 일치하는 UsernameToMatch 사용자 이름을 기준으로 필터링됩니다.

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

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

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

• Shared와 함께 PathToMatchscope.

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