WebPartManager.SaveCustomPersonalizationState Method

Note: This method is new in the .NET Framework version 2.0.

Saves custom personalization state data maintained by the WebPartManager control, so that this data can be reloaded whenever the page is reloaded.

Namespace: System.Web.UI.WebControls.WebParts
Assembly: System.Web (in system.web.dll)

protected virtual void SaveCustomPersonalizationState (
	PersonalizationDictionary state
)
protected void SaveCustomPersonalizationState (
	PersonalizationDictionary state
)
protected function SaveCustomPersonalizationState (
	state : PersonalizationDictionary
)

Parameters

state

A PersonalizationDictionary that contains the state data to be loaded.

The SaveCustomPersonalizationState method is critical in the process of personalization, because it enables personalized user settings to be stored for future browser sessions and visits to a page. The method saves custom personalization state data, which includes items such as the following: dynamic WebPart or server controls that have been added to a page or deleted from a page; controls that have been moved on a page; and dynamic connections that have been created or deleted.

You cannot call this method directly from your code. You can, however, call the System.Web.UI.WebControls.WebParts.IPersonalizable.Save method, which itself calls this method to save personalization data.

Notes to Inheritors Developers can override this method in a derived WebPartManager class to customize the process of saving personalization data.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: