PersonalizationProvider.ResetState 메서드

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

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

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

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

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

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

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

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

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

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

• 매개 변수는 usernames 쉼표(,)를 포함할 수 없습니다.

• SQL 데이터베이스의 paths 매개 변수 길이는 256자를 초과할 수 없습니다.

• SQL 데이터베이스의 usernames 매개 변수 길이는 256자를 초과할 수 없습니다.