PersonalizationProvider.ResetState Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Při přepsání v odvozené třídě odstraní stav individuálního nastavení ze základního úložiště dat na základě zadaných parametrů.

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

PersonalizationScopeInformace o individuálním nastavení, které se má resetovat. Tato hodnota nemůže být null .

paths

String[]

Cesty pro informace o individuálním nastavení, které se mají odstranit

usernames

String[]

Uživatelská jména pro informace o individuálním nastavení, která se mají odstranit

Návraty

Int32

Počet odstraněných řádků

Poznámky

Tato metoda je abstraktní definicí metody správy pro odstranění dat individuálního nastavení. Odvozené implementace by měly následovat po logice popsané níže.

Tato metoda nepodporuje žádná hledání pomocí zástupných znaků. Pokud poskytovatel individuálního nastavení zpřístupňuje data z úložiště dat s podporou transakcí, tato metoda by měla provádět své operace jako jediná atomická transakce.

Jsou povoleny pouze následující kombinace parametrů:

• scopeParametr je nastaven a všechny ostatní parametry jsou nastaveny na hodnotu null . tato kombinace odstraní všechna Webové částiá data individuálního nastavení přidružená k oboru individuálního nastavení, který uvádí scope .

• scopeParametr je nastaven a paths parametr obsahuje alespoň jednu hodnotu. tato kombinace odstraní všechna Webové částiá data individuálního nastavení pro zadanou cestu nebo cesty v oboru individuálního nastavení, který určuje scope .

• scopeParametr je nastaven na User , paths parametr je nastaven a obsahuje pouze jednu hodnotu a usernames parametr obsahuje alespoň jednu hodnotu. tato kombinace odstraní data všech individuálních nastavení uživatelů Webové části pro danou cestu, která je přidružená k uživateli nebo uživatelům obsaženým v usernames .

• scopeParametr je nastaven na User , paths parametr je nastaven na hodnotu null a usernames parametr obsahuje alespoň jednu hodnotu. tato kombinace odstraní všechna individuální přizpůsobení pro jednotlivé uživatele Webové části data ve všech cestách, která jsou přidružená k uživateli nebo uživatelům obsaženým v usernames .

Jakákoli jiná kombinace hodnot parametrů je neplatná a vyvolá ArgumentException výjimku. Konkrétně nejsou povoleny následující dvě kombinace:

• Pokud usernames je parametr nastavený na , parametr není možné scope Shared poskytnuta.

• Parametr paths nemůže obsahovat více než jednu položku, pokud parametr není usernames null .

Všechny paths hodnoty parametrů a obsažené v příslušných usernames polích musí splňovat následující ověřovací pravidla. Pokud u jakéhokoli člena polí parametrů dojde k selhání jakýchkoli ověřovacích ArgumentException pravidel, je vyvolána výjimka. Ověřovací pravidla jsou následující:

• null hodnoty nejsou povolené.

• Prázdný řetězec ("") není povolený. Parametry by se měly před provedením kontroly prázdného řetězce oříznuty.

• Parametr usernames nesmí obsahovat čárky (,).

• Délka parametru paths nesmí být delší než 256 znaků pro SQL databázi.

• Délka parametru usernames nesmí být delší než 256 znaků pro SQL databázi.