PersonalizationProvider.ResetState Metoda

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

Parametry

Zwraca

Liczba usuniętych wierszy.

Uwagi

Ta metoda jest abstrakcyjną definicją metody administracyjnej do usuwania danych personalizacji. Implementacje pochodne powinny być zgodne z logiką opisaną poniżej.

Ta metoda nie obsługuje wyszukiwania symboli wieloznacznych. Jeśli dostawca personalizacji uwidacznia dane z magazynu danych z obsługą transakcji, ta metoda powinna wykonywać swoje operacje jako pojedyncza transakcja niepodzielna.

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

• Parametr scope jest ustawiony, a wszystkie inne parametry są ustawione na nullwartość . Ta kombinacja powoduje usunięcie wszystkich danych personalizacji składników Web Part skojarzonych z zakresem personalizacji wskazanym przez element scope.

• 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 w zakresie personalizacji wskazane przez scope.

• Parametr scope jest ustawiony na Userwartość , paths parametr jest ustawiony i zawiera tylko jedną wartość, a usernames parametr zawiera co najmniej jedną wartość. Ta kombinacja powoduje usunięcie wszystkich danych składników Web Part personalizacji użytkownika dla danej ścieżki skojarzonej z użytkownikiem lub użytkownikami zawartymi w programie usernames.

• Parametr scope jest ustawiony na User, paths parametr jest ustawiony na 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 elem usernames.

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

• Nie można podać parametru usernames w przypadku scope ustawienia wartości Shared.

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

Wszystkie paths wartości parametrów 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 zostanie zgłoszony wyjątek. Reguły sprawdzania poprawności to:

• null wartości są niedozwolone.

• Pusty ciąg ("") jest niedozwolony. Parametry należy przyciąć przed wykonaniem pustego sprawdzania ciągu.

• Parametr usernames nie może zawierać przecinków (,).

• Długość parametru paths nie może być większa niż 256 znaków dla bazy danych SQL.

• Długość parametru usernames nie może być większa niż 256 znaków dla bazy danych SQL.