WebPart.SetPersonalizationDirty Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt ein Flag fest, das angibt, dass Personalisierungsdaten für ein Webparts-Steuerelement oder ein Serversteuerelement, das sich in einer WebPartZoneBase-Zone befindet, geändert wurden.
Überlädt
| SetPersonalizationDirty(Control) |
Legt ein Flag fest, das angibt, dass Personalisierungsdaten für das angegebene Serversteuerelement geändert wurden, das sich in einer WebPartZoneBase-Zone befindet. |
| SetPersonalizationDirty() |
Legt ein Flag fest, das angibt, dass Personalisierungsdaten für die aktuelle WebPart-Steuerelementinstanz geändert wurden. |
SetPersonalizationDirty(Control)
Legt ein Flag fest, das angibt, dass Personalisierungsdaten für das angegebene Serversteuerelement geändert wurden, das sich in einer WebPartZoneBase-Zone befindet.
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)Parameter
Ausnahmen
Das Objekt im control-Parameter hat den Wert null.
Das Steuerelement ist keiner Seite zugeordnet.
- oder -
Das Steuerelement wird von WebPart abgeleitet. Von WebPart abgeleitete Steuerelemente müssen die geschützte SetPersonalizationDirty()-Methode verwenden.
Die dem Steuerelement zugeordnete Seite besitzt keinen WebPartManager.
Hinweise
Die WebPart.SetPersonalizationDirty -Methode hat den gleichen Zweck wie die WebPart.SetPersonalizationDirty() -Methode, nämlich ein Flag festzulegen, das angibt, dass die Steuerungszustandsdaten während einer HTTP-Anforderung GET auf einem Serversteuerelement geändert (personalisiert) wurden. Der Unterschied zwischen diesen Methoden besteht darin, dass die WebPart.SetPersonalizationDirty -Methode für Serversteuerelemente verwendet wird, die nicht von der WebPart -Klasse erben, sondern innerhalb von WebPartZoneBase Zonen platziert werden, um an Webparts-Anwendungen teilzunehmen.
Weitere Informationen
Gilt für:
SetPersonalizationDirty()
Legt ein Flag fest, das angibt, dass Personalisierungsdaten für die aktuelle WebPart-Steuerelementinstanz geändert wurden.
protected:
void SetPersonalizationDirty();protected void SetPersonalizationDirty ();member this.SetPersonalizationDirty : unit -> unitProtected Sub SetPersonalizationDirty ()Ausnahmen
WebPartManager ist null
Hinweise
Die SetPersonalizationDirty -Methode legt ein Flag fest, das angibt, dass Steuerungszustandsdaten für ein WebPart Steuerelement geändert (personalisiert) wurden und dass das WebPartManager Steuerelement daher die Personalisierungsdaten in einer langfristigen Speicherung beibehalten muss.
WebPartManager Normalerweise werden Personalisierungsänderungen für WebPart Steuerelemente beibehalten, ohne dass Entwickler die SetPersonalizationDirty -Methode aufrufen müssen. Es gibt jedoch zwei Fälle, in denen Entwickler diese Methode aufrufen müssen. Der erste Fall ist, wenn Steuerstatusdaten während einer HTTP-Anforderung GET an eine Seite geändert werden. Standardmäßig werden Änderungen an steuerungsrelevanten Zustandsdaten während einer GET Anforderung (aus Sicherheitsgründen) nicht beibehalten.
SetPersonalizationDirty Die -Methode bietet jedoch eine Möglichkeit, legitime Personalisierungsänderungen an WebPart Steuerelementen in diesem Fall beizubehalten.
Der zweite Fall für den Aufruf der SetPersonalizationDirty -Methode tritt während einer HTTP-Anforderung POST an eine Seite auf. Wenn ein WebPart Steuerelement über komplexe personalisierbare Eigenschaften verfügt (z. B. eine Eigenschaft, die ein ArrayList Objekt enthält) und die Zustandsdaten in diesen Eigenschaften während einer POST Anforderung personalisiert werden, müssen Entwickler die SetPersonalizationDirty -Methode aufrufen, um sicherzustellen, dass die Änderungen beibehalten werden.
