WebPart.SetPersonalizationDirty Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Nastaví příznak označující, že se data přizpůsobení změnila pro ovládací prvek Webové části nebo serverový ovládací prvek umístěný v WebPartZoneBase zóně.

Přetížení

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

SetPersonalizationDirty(Control)

Nastaví příznak označující, že se data přizpůsobení změnila pro zadaný ovládací prvek serveru, 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

Údaje Control o přizpůsobení se změnily.

Výjimky

ArgumentNullException

Objekt v parametru control je null.

ArgumentException

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

-nebo- Ovládací prvek je odvozen od 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 o stavu ovládacího prvku byla změněna (přizpůsobená) na ovládacím prvku serveru během požadavku HTTP GET . Rozdíl mezi těmito metodami spočívá v tom, že WebPart.SetPersonalizationDirty metoda se používá pro ovládací prvky serveru, které nedědí z WebPart třídy, ale jsou umístěny do WebPartZoneBase zón pro účast v Webové části aplikací.

Viz také

• ovládací prvky ASP.NET Webové části

SetPersonalizationDirty()

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

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ůsobená) na ovládacím WebPart prvku a že WebPartManager ovládací prvek proto musí uchovávat data přizpůsobení do dlouhodobého úložiště.

Za normálníchokolnostch WebPartManager WebPart SetPersonalizationDirty Existují ale dva případy, kdy vývojáři potřebují tuto metodu volat. Prvním případem je změna dat o stavu řízení během požadavku HTTP GET na stránku. Ve výchozím nastavení se změny dat o stavu řízení během GET požadavku neudržují (pro účely zabezpečení). Metoda SetPersonalizationDirty ale poskytuje způsob, jak zachovat legitimní změny přizpůsobení ovládacích WebPart prvků v tomto případě.

Druhý případ volání SetPersonalizationDirty metody probíhá během požadavku HTTP POST na stránku. WebPart Pokud má ovládací prvek komplexní personalizovatelné vlastnosti (například vlastnost, která obsahuje ArrayList objekt) a data o stavu řízení v těchto vlastnostech jsou přizpůsobená během POST požadavku, musí vývojáři volat metoduSetPersonalizationDirty, aby se zajistilo, že změny budou zachovány.

Viz také

• ovládací prvky ASP.NET Webové části