SqlPersonalizationProvider.FindState 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

지정된 범위 및 매개 변수에 따라 0개 이상의 PersonalizationStateInfo파생 개체가 포함된 컬렉션을 반환합니다.

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 쿼리할 개인 설정 정보를 나타내는 A. 이 값은 null일 수 없습니다.

query

PersonalizationStateQuery

PersonalizationStateQuery 쿼리를 포함하는 항목입니다. 이 값은 null일 수 있습니다.

pageIndex

Int32

쿼리가 시작되는 위치입니다.

pageSize

Int32

반환할 레코드 수입니다.

totalRecords

Int32

사용 가능한 총 레코드 수입니다.

반환

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection 0개 이상의 PersonalizationStateInfo파생 개체를 포함하는 개체입니다.

예외

ArgumentException

pageIndex가 0보다 작습니다.

-또는-

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

-또는-

Int32.MaxValue보다 큰 값을 조합 pageIndex 하여 pageSize 생성합니다.

-또는-

PathToMatch 가 아닌 경우null 트리밍 후 빈 문자열("")입니다.

-또는-

값이 아닌null 경우 길이 PathToMatch 가 256자를 초과합니다.

-또는-

UsernameToMatch 가 아닌 경우null 트리밍 후 빈 문자열입니다.

-또는-

값이 아닌null 경우 길이 UsernameToMatch 가 256자를 초과합니다.

ArgumentOutOfRangeException

scope 지정된 값이 열거형의 유효한 값이 PersonalizationScope 아닙니다.

설명

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

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

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

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

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

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

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

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

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

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

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

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

• Shared범위와 .PathToMatch

• User범위와 , 및 속성의 PathToMatchUsernameToMatch모든 값과 UserInactiveSinceDate 결합됩니다.