WebPart.SetPersonalizationDirty Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Ustawia flagę wskazującą, że dane personalizacji uległy zmianie 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 uległy zmianie 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 WebPartelementu . 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 ma ustawić flagę wskazującą, ż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 do 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 uległy zmianie 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 i że WebPartManager w związku z tym kontrolka musi utrwałać dane personalizacji do długoterminowego magazynu.

WebPartManager Zwykle zmiany personalizacji są utrwalane w kontrolkach WebPart bez konieczności wywoływania SetPersonalizationDirty metody przez 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 w kontrolce danych stanu podczas GET żądania nie są utrwalane (na potrzeby zabezpieczeń). SetPersonalizationDirty Jednak metoda zapewnia sposób utrwalania uzasadnionych zmian WebPart personalizacji kontrolek 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 kontroli 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