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 Kennzeichen fest, das angibt, dass sich Personalisierungsdaten für ein Webpart-Steuerelement oder ein Serversteuerelement in einer WebPartZoneBase Zone geändert haben.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 Kennzeichen 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 lautet null.
Das Steuerelement ist keiner Seite zugeordnet.
-oder-
Das Steuerelement wird von WebPart. Steuerelemente, die von WebPart dieser abgeleitet werden, sollten stattdessen die geschützte SetPersonalizationDirty() Methode verwenden.
Die dem Steuerelement zugeordnete Seite besitzt WebPartManagerkeine .
Hinweise
Die WebPart.SetPersonalizationDirty Methode hat denselben Zweck wie die Methode, mit der WebPart.SetPersonalizationDirty() ein Flag festgelegt wird, das angibt, dass Steuerelementstatusdaten in einem Serversteuerelement während einer HTTP-Anforderung GET 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 in WebPartZoneBase Zonen platziert werden, um an Webpartanwendungen teilzunehmen.
Weitere Informationen
Gilt für:
SetPersonalizationDirty()
Legt ein Kennzeichen 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 Steuerelementstatusdaten in einem WebPart Steuerelement geändert (personalisiert) wurden und dass das WebPartManager Steuerelement daher die Personalisierungsdaten auf einen langfristigen Speicher beibehalten muss.
Normalerweise werden die WebPartManager 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 Steuerelementstatusdaten während einer HTTP-Anforderung GET an eine Seite geändert werden. Änderungen an den Zustandsdaten während einer GET Anforderung werden standardmäßig nicht beibehalten (für Sicherheitszwecke).
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 komplexe personalisierbare Eigenschaften aufweist (z. B. eine Eigenschaft, die ein ArrayList Objekt enthält) und Die Statusdaten in diesen Eigenschaften während einer POST Anforderung personalisiert werden, müssen Entwickler die SetPersonalizationDirty Methode aufrufen, um sicherzustellen, dass die Änderungen beibehalten werden.
