PersonalizationAdministration.GetCountOfUserState(String) 메서드

정의

지정된 사용자에 대해 내부 데이터 저장소에 있는 개인 설정 상태 항목의 수를 반환합니다.

public:
 static int GetCountOfUserState(System::String ^ usernameToMatch);
public static int GetCountOfUserState (string usernameToMatch);
static member GetCountOfUserState : string -> int
Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

매개 변수

usernameToMatch
String

검색할 개인 설정 상태 정보에 관련된 사용자 이름입니다.

반환

지정된 사용자에 대한 개인 설정 상태 항목의 수입니다.

예외

트리밍 후 usernameToMatch가 빈 문자열인 경우

또는

구성에 정의된 개인 설정 공급자에 대한 공급자 형식이 올바르지 않은 경우

또는

매개 변수의 문자열 길이가 256자보다 긴 경우

구성된 개인 설정 공급자 중 하나의 인스턴스를 만들고 초기화하려는 동안 구성 예외가 발생한 경우

또는

구성에 정의된 기본 개인 설정 공급자를 찾을 수 없는 경우

기본 공급자가 개수로 음수를 반환한 경우

설명

이 메서드는 지정된 usernameToMatch에 대해 존재하는 기본 데이터 저장소의 사용자별 개인 설정 항목 수를 반환합니다.

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

일반적으로 SQL 규격 데이터 저장소의 경우 부분 사용자 이름에 대한 와일드카드 검색은 속성의 UsernameToMatch 텍스트 문자열에서 언제든지 와일드카드 문자를 표시할 수 있습니다. 예를 들어 "John"으로 시작하는 모든 사용자 이름을 찾으려면 매개 변수는 UsernameToMatch "John%"과 같습니다.

합니다 usernameToMatch 매개 변수 수 null입니다. 로 null설정하면 쿼리를 수행할 때 매개 변수가 무시됩니다. usernameToMatch Microsoft SQL Server를 실행하는 데이터 저장소와 같은 일부 데이터 저장소는 와일드카드 문자로 쉼표를 허용하므로 매개 변수에 쉼표(,)가 있을 수 있습니다.

적용 대상

추가 정보