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 쿼리할 개인 설정 정보를 나타내는 A. 이 값은 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%"과 같습니다.

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

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

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

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

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

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

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

• Shared범위와 .PathToMatch

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