PersonalizationProvider.ResetState 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

파생 클래스에서 재정의된 경우 지정된 매개 변수를 기반으로 내부 데이터 저장소에서 개인 설정 상태를 삭제합니다.

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

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

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

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

매개 변수

scope

PersonalizationScope

다시 설정할 개인 설정 정보의 PersonalizationScope입니다. 이 값은 null일 수 없습니다.

paths

String[]

삭제할 개인 설정 정보의 경로입니다.

usernames

String[]

삭제할 개인 설정 정보의 사용자 이름입니다.

반환

Int32

삭제되는 행의 수입니다.

설명

이 메서드는 개인 설정 데이터를 삭제 하는 관리 방법의 추상 정의입니다. 파생 된 구현은 아래에 설명 된 논리를 따라야 합니다.

이 메서드에서는 와일드 카드 문자 검색을 지원 하지 않습니다. 개인 설정 공급자가 트랜잭션 인식 데이터 저장소의 데이터를 노출 하는 경우이 메서드는 단일 원자성 트랜잭션으로 작업을 수행 해야 합니다.

다음 매개 변수 조합만 사용할 수 있습니다.

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

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

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

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

매개 변수 값의 다른 모든 조합은 유효 하지 않으며 예외를 throw ArgumentException 합니다. 특히 다음 두 가지 조합은 허용 되지 않습니다.

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

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

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

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

• 빈 문자열 ("")은 허용 되지 않습니다. 빈 문자열 검사를 수행 하기 전에 매개 변수를 잘라내야 합니다.

• usernames매개 변수에는 쉼표 (,)를 사용할 수 없습니다.

• pathsSQL 데이터베이스에 대 한 매개 변수 길이는 256 자를 초과할 수 없습니다.

• usernamesSQL 데이터베이스에 대 한 매개 변수 길이는 256 자를 초과할 수 없습니다.