WebPart.SetPersonalizationDirty 方法

定义

设置一个标志,以指示放入 WebPartZoneBase 区域中的 Web 部件控件或服务器控件的个性化数据已更改。

重载

SetPersonalizationDirty(Control)

设置一个标志,以指示驻留在 WebPartZoneBase 区域中的指定服务器控件的个性化数据已更改。

SetPersonalizationDirty()

设置一个标志,以指示当前 WebPart 控件实例的个性化数据已更改。

SetPersonalizationDirty(Control)

设置一个标志,以指示驻留在 WebPartZoneBase 区域中的指定服务器控件的个性化数据已更改。

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)

参数

control
Control

其个性化数据已更改的 Control

例外

control 参数中的对象为 null

该控件不与页相关联。

- 或 -

WebPart 中派生的控件。 从 WebPart 中派生的控件应使用受保护的 SetPersonalizationDirty() 方法。

与控件关联的页没有 WebPartManager

注解

方法 WebPart.SetPersonalizationDirty 与 方法具有相同的用途 WebPart.SetPersonalizationDirty() ,该方法是设置一个标志,指示在 HTTP GET 请求期间对服务器控件 (个性化) 更改了控件状态数据。 这些方法的区别在于, WebPart.SetPersonalizationDirty 方法用于不继承自 WebPart 类,但放置在区域中 WebPartZoneBase 以参与 Web 部件应用程序的服务器控件。

另请参阅

适用于

SetPersonalizationDirty()

设置一个标志,以指示当前 WebPart 控件实例的个性化数据已更改。

protected:
 void SetPersonalizationDirty();
protected void SetPersonalizationDirty ();
member this.SetPersonalizationDirty : unit -> unit
Protected Sub SetPersonalizationDirty ()

例外

注解

方法 SetPersonalizationDirty 设置一个标志,指示控件状态数据已更改 (控件上的 WebPart 个性化) , WebPartManager 因此控件需要将个性化设置数据保存到长期存储。

通常, 在 WebPartManager 控件上 WebPart 保留个性化设置更改,而无需开发人员调用 SetPersonalizationDirty 方法。 但在两种情况下,开发人员确实需要调用此方法。 第一种情况是在向页面发出 HTTP GET 请求期间更改控制状态数据。 默认情况下,出于安全目的) ,不会保留请求期间 GET 控制状态数据的更改 (。 但是, SetPersonalizationDirty 方法提供了一种将合法个性化设置更改保留到 WebPart 这种情况下的控件的方法。

调用 SetPersonalizationDirty 方法的第二种情况发生在对页面的 HTTP POST 请求期间。 WebPart如果控件具有复杂的可个性化设置属性 (例如包含ArrayList对象) 的属性,并且这些属性中的控件状态数据在请求期间是个性化设置的POST,开发人员必须调用 SetPersonalizationDirty 方法以确保保留更改。

另请参阅

适用于