PersonalizationAdministration.GetCountOfUserState(String) 메서드

정의

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

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

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

검색할 개인 설정 상태 정보와 연결된 사용자 이름입니다.

반품

Int32

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

예외

ArgumentException

usernameToMatch 은 트리밍 후 빈 문자열("")입니다.

-또는-

구성에 정의된 개인 설정 공급자에 대한 공급자가 올바른 형식이 아닙니다.

-또는-

매개 변수의 문자열 길이가 256자를 초과합니다.

ConfigurationErrorsException

구성된 개인 설정 공급자 중 하나의 인스턴스를 만들고 초기화하는 동안 구성 예외가 발생했습니다.

-또는-

구성에 정의된 기본 개인 설정 공급자를 찾을 수 없습니다.

HttpException

기본 공급자는 개수에 대해 음수를 반환했습니다.

설명

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

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

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

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

적용 대상

추가 정보