PersonalizationProvider.GetCountOfState 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

파생 클래스에서 재정의된 경우 내부 데이터 저장소에서 지정된 범위 안에 있는 행의 수를 반환합니다.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);

public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);

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

Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

매개 변수

scope

PersonalizationScope

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

query

PersonalizationStateQuery

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

반환

Int32

지정된 scope 매개 변수에 대해 내부 데이터 저장소에 있는 행의 수입니다.

설명

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

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

일반적으로 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 특정 사용자 이름과 연결된 개인 설정 상태 레코드 수를 요청할 수 있습니다. 사용자 이름은 공유 정보와 연결되지 않으므로 반환된 개수는 0이 됩니다.

0이 아닌 개수를 반환할 가능성이 있는 매개 변수 조합은 다음과 같습니다.

• Shared속성과 PathToMatch 함께 scope.

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