WebPart.SetPersonalizationDirty Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Nastaví příznak označující, že u ovládacího prvku webových částí nebo serverového ovládacího prvku umístěného v zóně došlo ke WebPartZoneBase změně dat přizpůsobení.

Přetížení

SetPersonalizationDirty(Control)	Nastaví příznak označující, že se změnila data přizpůsobení zadaného serverového ovládacího prvku, který se nachází v WebPartZoneBase zóně.
SetPersonalizationDirty()	Nastaví příznak označující, že se pro instanci aktuálního WebPart ovládacího prvku změnila data přizpůsobení.

SetPersonalizationDirty(Control)

Nastaví příznak označující, že se změnila data přizpůsobení zadaného serverového ovládacího prvku, který se nachází v WebPartZoneBase zóně.

public:
 static void SetPersonalizationDirty(System::Web::UI::Control ^ control);

public static void SetPersonalizationDirty (System.Web.UI.Control control);

static member SetPersonalizationDirty : System.Web.UI.Control -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

Parametry

control

Control

Hodnota Control , pro kterou se osobní údaje změnily.

Výjimky

ArgumentNullException

Objekt v parametru control je null.

ArgumentException

Ovládací prvek není přidružen ke stránce.

-nebo-

Ovládací prvek je odvozen z WebPart. Ovládací prvky odvozené z WebPart by měly místo toho používat chráněnou SetPersonalizationDirty() metodu.

InvalidOperationException

Stránka přidružená k ovládacímu prvku nemá WebPartManager.

Poznámky

Metoda WebPart.SetPersonalizationDirty má stejný účel jako WebPart.SetPersonalizationDirty() metoda , což je nastavení příznaku označujícího, že data stavu ovládacího prvku byla změněna (přizpůsobena) na ovládacím prvku serveru během požadavku HTTP GET . Rozdíl mezi těmito metodami je, že WebPart.SetPersonalizationDirty metoda se používá pro ovládací prvky serveru, které nedědí z WebPart třídy, ale jsou umístěny v zónách WebPartZoneBase , aby se zapojily do aplikací webových částí.

Viz také

• ASP.NET ovládací prvky webových částí

SetPersonalizationDirty()

Nastaví příznak označující, že se pro instanci aktuálního WebPart ovládacího prvku změnila data přizpůsobení.

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

Výjimky

InvalidOperationException

WebPartManager je null.

Poznámky

Metoda SetPersonalizationDirty nastaví příznak označující, že data o stavu ovládacího prvku byla změněna (přizpůsobena) WebPart a že WebPartManager ovládací prvek proto musí data přizpůsobení uchovávat v dlouhodobém úložišti.

Za normálních WebPartManager okolností se změny přizpůsobení u WebPart ovládacích prvků zachová, aniž by vývojáři museli metodu SetPersonalizationDirty volat. Existují ale dva případy, kdy vývojáři potřebují tuto metodu volat. Prvním případem je změna dat stavu řízení během požadavku HTTP GET na stránku. Ve výchozím nastavení se změny řízení dat o stavu během GET požadavku neuchovávají (z bezpečnostních důvodů). SetPersonalizationDirty Metoda ale poskytuje způsob, jak v tomto případě zachovat legitimní změny WebPart přizpůsobení ovládacích prvků.

Druhý případ volání SetPersonalizationDirty metody nastane během požadavku HTTP POST na stránku. WebPart Pokud má ovládací prvek složité přizpůsobitelné vlastnosti (například vlastnost, která obsahuje ArrayList objekt) a data o stavu ovládacích prvků v těchto vlastnostech jsou přizpůsobena během POST požadavku, musí vývojáři zavolat metodu SetPersonalizationDirty , aby zajistili, že změny jsou zachovány.

Viz také

• ASP.NET ovládací prvky webových částí