WebPart.SetPersonalizationDirty Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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í
| Name | Description |
|---|---|
| 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í pro aktuální WebPart instanci ovládacího prvku změnila. |
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
Výjimky
Objekt v parametru control je null.
Ovládací prvek není přidružený ke 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.
Stránka přidružená k ovládacímu prvku nemá WebPartManager.
Poznámky
Metoda WebPart.SetPersonalizationDirty má stejný účel jako WebPart.SetPersonalizationDirty() metoda, která nastaví příznak označující, že data o stavu řízení 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 spočívá v WebPart.SetPersonalizationDirty tom, že metoda se používá pro serverové ovládací prvky, které nedědí z WebPart třídy, ale jsou umístěny do WebPartZoneBase zón pro účast v aplikacích webových částí.
Viz také
Platí pro
SetPersonalizationDirty()
Nastaví příznak označující, že se data přizpůsobení pro aktuální WebPart instanci ovládacího prvku změnila.
protected:
void SetPersonalizationDirty();
protected void SetPersonalizationDirty();
member this.SetPersonalizationDirty : unit -> unit
Protected Sub SetPersonalizationDirty ()
Výjimky
WebPartManager je null.
Poznámky
Metoda SetPersonalizationDirty nastaví příznak označující, že data stavu ovládacího prvku byla změněna (přizpůsobena) na ovládacím WebPart prvku a že WebPartManager ovládací prvek proto potřebuje zachovat data přizpůsobení do dlouhodobého úložiště.
Za normálníchokolnostch WebPartManagerWebPartSetPersonalizationDirty 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 neuchovávají (pro účely zabezpečení). Metoda SetPersonalizationDirty 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 probíhá během požadavku HTTP POST na stránku.
WebPart Pokud má ovládací prvek komplexní personalizovatelné vlastnosti (například vlastnost obsahující ArrayList objekt) a data o stavu řízení v těchto vlastnostech jsou přizpůsobena během POST požadavku, vývojáři musí metodu SetPersonalizationDirty volat, aby se zajistilo, že změny budou zachovány.