WebPart.SetPersonalizationDirty Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
| Nazwa | Opis |
|---|---|
| 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 -> unitPublic Shared Sub SetPersonalizationDirty (control As Control)Parametry
Wyjątki
Obiekt w parametrze control to null.
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() .
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 w przypadku 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ż
Dotyczy
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 -> unitProtected Sub SetPersonalizationDirty ()Wyjątki
Parametr WebPartManager ma wartość null.
Uwagi
Metoda SetPersonalizationDirty ustawia flagę wskazującą, że dane stanu kontroli zostały zmienione (spersonalizowane) w kontrolce WebPart i że 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 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 do strony. Domyślnie zmiany dotyczące kontroli danych stanu podczas GET żądania nie są utrwalane (w celach bezpieczeństwa).
SetPersonalizationDirty Jednak metoda zapewnia sposób utrwalania legalnych zmian personalizacji w WebPart 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 umożliwiające personalizację (takie jak właściwość zawierająca ArrayList obiekt), a dane stanu kontroli w tych właściwościach są spersonalizowane podczas POST żądania, deweloperzy muszą wywołać SetPersonalizationDirty metodę, aby upewnić się, że zmiany są utrwalane.
