SqlPersonalizationProvider.ResetState 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 매개 변수를 기반으로 내부 데이터 저장소에서 개인 설정 상태 정보를 삭제합니다.
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[] -> intPublic Overrides Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer매개 변수
- scope
- PersonalizationScope
쿼리할 개인 설정 정보를 나타내는 PersonalizationScope입니다. 이 값은 null일 수 없습니다.
반환
삭제되는 행의 수입니다.
예외
paths 또는 usernames 매개 변수가 빈 배열인 경우
또는
각 배열에 포함된 paths 및 usernames 매개 변수가 유효성 검사 규칙을 충족하지 않는 경우
지정된 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자를 초과할 수 없습니다.