SqlPersonalizationProvider.ResetState Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Usuwa informacje o stanie personalizacji z bazowego magazynu danych na podstawie określonych parametrów.

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

Parametry

scope

PersonalizationScope

Element PersonalizationScope wskazujący informacje o personalizacji, które mają być odpytywane. Ta wartość nie może być nullwartością .

paths

String[]

Ścieżki do informacji o personalizacji w Shared zakresie, który ma zostać usunięty.

usernames

String[]

Nazwy użytkowników dla informacji o personalizacji w User zakresie, który ma zostać usunięty.

Zwraca

Int32

Liczba usuniętych wierszy.

Wyjątki

ArgumentException

Parametr paths lub usernames jest pustą tablicą.

-lub- Parametry paths i usernames zawarte w odpowiednich tablicach nie spełniają reguł walidacji.

ArgumentOutOfRangeException

Określona scope wartość nie jest elementem członkowskim wyliczenia PersonalizationScope .

Uwagi

W tej metodzie nie są obsługiwane żadne znaki wieloznaczne.

Dozwolone są tylko następujące kombinacje parametrów:

• Parametr scope jest ustawiony, a wszystkie inne parametry są ustawione na nullwartość . Ta kombinacja usuwa wszystkie dane personalizacji składników Web Part skojarzone z zakresem personalizacji określonym przez scopeelement .

• Parametr scope jest ustawiony, a paths parametr zawiera co najmniej jedną wartość. Ta kombinacja usuwa wszystkie dane personalizacji składników Web Part dla określonej ścieżki lub ścieżek, które znajdują się w zakresie personalizacji wskazane przez scope.

• Parametr scope jest ustawiony na User, paths parametr jest ustawiony i zawiera tylko jedną ścieżkę, a usernames parametr zawiera co najmniej jedną wartość. Ta kombinacja usuwa wszystkie dane składników Web Part personalizacji użytkownika dla danej ścieżki skojarzonej z użytkownikiem lub użytkownikami znajdującymi się w usernamespliku .

• Parametr scope jest ustawiony na User, paths parametr to null, a usernames parametr zawiera co najmniej jedną wartość. Ta kombinacja usuwa wszystkie dane składników Web Part personalizacji poszczególnych użytkowników we wszystkich ścieżkach skojarzonych z użytkownikiem lub użytkownikami zawartymi w usernamesprogramie .

Każda inna kombinacja wartości parametrów jest nieprawidłowa i zgłosi ArgumentException wyjątek. Na przykład następujące dwie kombinacje są niedozwolone:

• Nie usernames można podać parametru scope , gdy parametr jest ustawiony na Sharedwartość .

• Parametr paths nie może zawierać więcej niż jednego wpisu, jeśli usernames parametr nie nulljest .

Parametry paths i usernames zawarte w odpowiednich tablicach muszą spełniać następujące reguły walidacji. Jeśli jakiekolwiek reguły walidacji nie powiedzą się dla dowolnego elementu członkowskiego tablic parametrów, ArgumentException zgłaszany jest wyjątek. Reguły sprawdzania poprawności obejmują:

• null wartości są niedozwolone.

• Pusty ciąg ("") po przycięciu ciągu jest niedozwolony.

• Żadne nazwy użytkowników zawarte w parametrze usernames nie mogą zawierać przecinków.

• Długość dowolnej ścieżki w parametrze paths nie może być większa niż 256 znaków.

• Długość nazwy użytkownika w parametrze usernames nie może być większa niż 256 znaków.