SqlPersonalizationProvider.ResetState Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Odstraní informace o stavu přizpůsobení z podkladového úložiště dat na základě zadaných parametrů.

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

Označení PersonalizationScope informací o přizpůsobení, které se mají dotazovat. Tato hodnota nemůže být null.

paths

String[]

Cesty k přizpůsobení informací v Shared oboru, který se má odstranit.

usernames

String[]

Uživatelská jména pro osobní údaje v User oboru, který se má odstranit.

Návraty

Int32

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

Výjimky

ArgumentException

Buď parametr paths , nebo usernames parametr je prázdné pole.

-nebo- usernames Parametry paths obsažené v příslušných polích nesplňují ověřovací pravidla.

ArgumentOutOfRangeException

Zadaný scope není členem výčtu PersonalizationScope .

Poznámky

Tato metoda nepodporuje žádné zástupné znaky.

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

• Parametr scope je nastaven a všechny ostatní parametry jsou nastaveny na null. Tato kombinace odstraní všechna data Webové části přizpůsobení přidružená k rozsahu přizpůsobení označenému scope.

• Parametr scope je nastavený a paths parametr obsahuje alespoň jednu hodnotu. Tato kombinace odstraní všechna data Webové části přizpůsobení pro zadanou cestu nebo cesty, které jsou v rozsahu přizpůsobení označeném scope.

• Parametr scope je nastaven na User, paths parametr je nastaven a obsahuje pouze jednu cestu a usernames parametr obsahuje aspoň jednu hodnotu. Tato kombinace odstraní všechna data přizpůsobení uživatelů Webové části pro danou cestu, která je přidružená k uživateli nebo uživatelům obsaženým v usernames.

• Parametr scope je nastaven na User, paths parametr je nulla usernames parametr obsahuje alespoň jednu hodnotu. Tato kombinace odstraní všechna individuální nastavení pro uživatele Webové části data ve všech cestách přidružených 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. Například následující dvě kombinace nejsou povoleny:

• Parametr usernames nelze zadat, pokud scope je parametr nastaven na Shared.

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

Parametry paths obsažené usernames v příslušných polích musí splňovat následující ověřovací pravidla. Pokud některá ověřovací pravidla pro některého člena polí parametrů selžou, ArgumentException vyvolá se výjimka. Ověřovací pravidla zahrnují:

• null hodnoty nejsou povoleny.

• Prázdný řetězec ("") po oříznutí řetězce není povolený.

• Žádná uživatelská jména obsažená v parametru usernames nesmí obsahovat čárky.

• Délka jakékoli cesty v parametru paths nesmí být větší než 256 znaků.

• Délka libovolného uživatelského jména v parametru usernames nesmí být větší než 256 znaků.