WebPart.SetPersonalizationDirty Methode

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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 -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

Parameter

control

Control

Das Control, für das die Personalisierungsdaten geändert wurden.

Ausnahmen

ArgumentNullException

Das Objekt im control-Parameter hat den Wert null.

ArgumentException

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.

InvalidOperationException

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

• ASP.NET Webparts-Steuerelemente

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 -> unit

Protected Sub SetPersonalizationDirty ()

Ausnahmen

InvalidOperationException

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.

Weitere Informationen

• ASP.NET Webparts-Steuerelemente