WebPart.SetPersonalizationDirty 方法

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

设置一个标志，以指示放入 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。

例外

ArgumentNullException

control 参数中的对象为 null。

ArgumentException

该控件不与页相关联。

- 或 -

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

InvalidOperationException

与控件关联的页没有 WebPartManager。

注解

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

另请参阅

• ASP.NET Web 部件控件

SetPersonalizationDirty()

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

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

例外

InvalidOperationException

WebPartManager 为 null。

注解

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

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

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

另请参阅

• ASP.NET Web 部件控件