SqlPersonalizationProvider.GetCountOfState 메서드

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls.WebParts
어셈블리:
System.Web.dll

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

public:
 override int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public override int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
override this.GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public Overrides Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

매개 변수

scope
PersonalizationScope

쿼리할 개인 설정 정보를 나타내는 PersonalizationScope입니다. 이 값은 null일 수 없습니다.

query
PersonalizationStateQuery

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

반환

Int32

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

예외

ArgumentException

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

또는

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

또는

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

또는

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

ArgumentOutOfRangeException

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

설명

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

일반적으로 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 비활성 사용자와 연결된 상태 레코드 수를 요청할 수 있습니다. 비활성 사용자 지정 개념이 없으므로 반환된 개수는 0입니다.

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

적용 대상