SqlPersonalizationProvider.ResetState 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

지정된 매개 변수를 기반으로 내부 데이터 저장소에서 개인 설정 상태 정보를 삭제합니다.

public:
 override int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);

public override int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);

override this.ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int

Public Overrides Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

매개 변수

scope

PersonalizationScope

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

paths

String[]

Shared 범위에서 삭제할 개인 설정 정보의 경로입니다.

usernames

String[]

User 범위에서 삭제할 개인 설정 정보의 사용자 이름입니다.

반환

Int32

삭제되는 행의 수입니다.

예외

ArgumentException

paths 또는 usernames 매개 변수가 빈 배열인 경우

또는 각 배열에 포함된 paths 및 usernames 매개 변수가 유효성 검사 규칙을 충족하지 않는 경우

ArgumentOutOfRangeException

지정된 scope가 PersonalizationScope 열거형의 멤버가 아닌 경우

설명

이 메서드에서 지원되는 와일드카드 문자는 없습니다.

다음 매개 변수 조합만 허용됩니다.

• 매개 변수가 scope 설정되고 다른 모든 매개 변수가 .로 null설정됩니다. 이 조합은 표시된 scope개인 설정 범위와 연결된 모든 웹 파트 개인 설정 데이터를 삭제합니다.

• scope 매개 변수가 설정되고 매개 변수에 paths 하나 이상의 값이 포함됩니다. 이 조합은 지정된 경로 또는 표시된 scope개인 설정 범위에 있는 경로에 대한 모든 웹 파트 개인 설정 데이터를 삭제합니다.

• 매개 변수가 scope 설정 User되고 매개 변수가 paths 설정되고 하나의 경로만 포함되며 매개 변수에 usernames 하나 이상의 값이 포함됩니다. 이 조합은 포함된 사용자 또는 사용자와 연결된 지정된 경로에 대한 모든 사용자 개인 설정 웹 파트 데이터를 삭제합니다usernames.

• 매개 변수가 scope 설정되고, paths 매개 변수가 null있으며, 매개 변수에 usernames 하나 이상의 값User이 포함됩니다. 이 조합은 포함된 사용자 또는 usernames사용자와 연결된 모든 경로에서 모든 사용자별 개인 설정 웹 파트 데이터를 삭제합니다.

매개 변수 값의 다른 조합이 잘못되었으며 예외가 ArgumentException throw됩니다. 예를 들어 다음 두 가지 조합은 허용되지 않습니다.

• 매개 변수가 usernames .로 설정된 Shared경우 매개 변수를 scope 제공할 수 없습니다.

• 매개 변수가 paths 아닌 경우 매개 변수에 둘 이상의 항목을 포함할 usernames 수 없습니다 null.

각 배열에 포함된 매개 변수와 usernames 매개 변수는 paths 다음 유효성 검사 규칙을 충족해야 합니다. 매개 변수 배열의 멤버에 대한 유효성 검사 규칙이 실패하면 예외가 ArgumentException throw됩니다. 유효성 검사 규칙은 다음과 같습니다.

• null 값은 허용되지 않습니다.

• 문자열이 잘려진 후 빈 문자열("")은 허용되지 않습니다.

• 매개 변수에 포함된 사용자 이름에는 쉼표가 usernames 포함될 수 없습니다.

• 매개 변수의 경로 paths 길이는 256자를 초과할 수 없습니다.

• 매개 변수의 사용자 이름 usernames 길이는 256자를 초과할 수 없습니다.