WebPart.SetPersonalizationDirty Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Ustawia flagę wskazującą, że dane personalizacji zostały zmienione dla kontrolki składników Web Part lub kontrolki serwera umieszczonej WebPartZoneBase w strefie.

Przeciążenia

SetPersonalizationDirty(Control)	Ustawia flagę wskazującą, że dane personalizacji zostały zmienione dla określonej kontrolki serwera, która znajduje się w WebPartZoneBase strefie.
SetPersonalizationDirty()	Ustawia flagę wskazującą, że dane personalizacji zostały zmienione dla bieżącego WebPart wystąpienia kontrolki.

SetPersonalizationDirty(Control)

Ustawia flagę wskazującą, że dane personalizacji zostały zmienione dla określonej kontrolki serwera, która znajduje się w WebPartZoneBase strefie.

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

Element Control , dla którego dane personalizacji uległy zmianie.

Wyjątki

ArgumentNullException

Obiekt w parametrze control to null.

ArgumentException

Kontrolka nie jest skojarzona ze stroną.

-lub-

Kontrolka pochodzi z klasy WebPart. Zamiast tego kontrolki pochodzące z WebPart programu powinny używać metody chronionej SetPersonalizationDirty() .

InvalidOperationException

Strona skojarzona z kontrolką nie ma elementu WebPartManager.

Uwagi

Metoda WebPart.SetPersonalizationDirty ma taki sam cel jak WebPart.SetPersonalizationDirty() metoda, która służy do ustawiania flagi wskazującej, że dane stanu kontroli zostały zmienione (spersonalizowane) w kontrolce serwera podczas żądania HTTP GET . Różnica między tymi metodami polega na tym, że WebPart.SetPersonalizationDirty metoda jest używana dla kontrolek serwera, które nie dziedziczą z WebPart klasy, ale są umieszczane w WebPartZoneBase strefach do udziału w aplikacjach składników Web Part.

Zobacz też

• kontrolki składników Web Part ASP.NET

SetPersonalizationDirty()

Ustawia flagę wskazującą, że dane personalizacji zostały zmienione dla bieżącego WebPart wystąpienia kontrolki.

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

Wyjątki

InvalidOperationException

WebPartManager to null.

Uwagi

Metoda SetPersonalizationDirty ustawia flagę wskazującą, że dane stanu kontroli zostały zmienione (spersonalizowane) w kontrolce WebPart , a w związku z tym kontrolka WebPartManager musi utrwalać dane personalizacji do długoterminowego przechowywania.

WebPartManager Zwykle zmiany personalizacji są utrwalane w WebPart kontrolkach bez konieczności wywoływania metody przez SetPersonalizationDirty deweloperów. Istnieją jednak dwa przypadki, w których deweloperzy muszą wywołać tę metodę. Pierwszy przypadek polega na zmianie danych stanu kontroli podczas żądania HTTP GET na stronę. Domyślnie zmiany stanu kontroli danych podczas GET żądania nie są utrwalane (dla celów bezpieczeństwa). SetPersonalizationDirty Jednak metoda zapewnia sposób utrwalania uzasadnionych zmian WebPart personalizacji w kontrolkach w tym przypadku.

Drugi przypadek wywoływania SetPersonalizationDirty metody występuje podczas żądania HTTP POST do strony. Jeśli kontrolka WebPart ma złożone właściwości personalizowalne (takie jak właściwość zawierająca ArrayList obiekt), a dane stanu sterowania w tych właściwościach są personalizowane podczas POST żądania, deweloperzy muszą wywołać SetPersonalizationDirty metodę , aby upewnić się, że zmiany są utrwalane.

Zobacz też

• kontrolki składników Web Part ASP.NET