WebPart.SetPersonalizationDirty Methode

  • Referenz

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 denselben Zweck wie die WebPart.SetPersonalizationDirty() -Methode, d. h. ein Flag festzulegen, das angibt, dass Die Steuerungsstatusdaten für ein 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 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 Die Steuerungsstatusdaten für ein WebPart Steuerelement geändert (personalisiert) wurden und dass das WebPartManager Steuerelement daher die Personalisierungsdaten langfristig speichern 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 Während einer HTTP-Anforderung GET an eine Seite Steuerstatusdaten geändert werden. Standardmäßig werden Änderungen an Steuerungsstatusdaten 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 das Aufrufen 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 während einer POST Anforderung Steuerelementstatusdaten in diesen Eigenschaften personalisiert werden, müssen Entwickler die SetPersonalizationDirty -Methode aufrufen, um sicherzustellen, dass die Änderungen beibehalten werden.

Weitere Informationen

Gilt für: