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 있고 querynull 반환 query 되는 속성 또는 기본값의 null 모든 속성인 경우 표시된 scope 매개 변수와 일치하는 모든 레코드가 계산됩니다.

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

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

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

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

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

적용 대상