Udostępnij za pośrednictwem


PersonalizationProvider.ResetState Metoda

Definicja

W przypadku przesłonięć w klasie pochodnej usuwa stan personalizacji z bazowego magazynu danych na podstawie określonych parametrów.

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

scope
PersonalizationScope

Część PersonalizationScope informacji personalizacji do zresetowania. Ta wartość nie może być null .

paths
String[]

Ścieżki do usunięcia informacji personalizacji.

usernames
String[]

Nazwy użytkowników dotyczące informacji personalizacji, które mają zostać usunięte.

Zwraca

Int32

Liczba usuniętych wierszy.

Uwagi

Ta metoda jest abstrakcyjną definicją metody administracyjnej 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 transakcjami, ta metoda powinna wykonywać swoje operacje jako pojedynczą transakcję niepodzielną.

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

  • Parametr scope jest ustawiony, a wszystkie inne parametry są ustawione na null wartość . Ta kombinacja usuwa wszystkie składniki Web Part personalizacji skojarzone z zakresem personalizacji wskazanym scope przez .

  • Parametr scope jest ustawiony, a paths parametr zawiera co najmniej jedną wartość. Ta kombinacja usuwa wszystkie składniki Web Part personalizacji dla określonej ścieżki lub ścieżek w zakresie personalizacji wskazanym scope przez .

  • Parametr jest ustawiony na wartość , parametr jest ustawiony i zawiera tylko jedną wartość, a parametr zawiera scope User co najmniej jedną paths usernames wartość. Ta kombinacja usuwa wszystkie dane personalizacji składniki Web Part dla danej ścieżki, która jest skojarzona z użytkownikiem lub użytkownikami zawartymi w programie usernames .

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

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

  • Nie usernames można określić parametru, gdy scope jest ustawiony na wartość Shared .

  • Parametr paths nie może zawierać więcej niż jednego wpisu, gdy parametr nie jest usernames null .

Wszystkie paths wartości parametrów i zawarte w odpowiednich usernames tablicach muszą spełniać następujące reguły weryfikacji. Jeśli jakiekolwiek reguły weryfikacji nie powiodą się dla dowolnego członka tablic parametrów, ArgumentException zostanie zgłoszony wyjątek. Reguły weryfikacji są:

  • null wartości są niedozwolone.

  • Pusty ciąg ("") jest niedozwolone. Parametry należy przycinać 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 SQL bazy danych.

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

Dotyczy