This documentation is archived and is not being maintained.

ITrackingPersonalizable Interface

Allows Web Parts controls to track the specific phases of the personalization load and save process.

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

public interface class ITrackingPersonalizable

The ITrackingPersonalizable type exposes the following members.

  NameDescription
Public propertyTracksChangesIndicates whether the control tracks the status of its changes.
Top

  NameDescription
Public methodBeginLoadRepresents the beginning of the load phase for personalization information.
Public methodBeginSaveRepresents the phase prior to extracting personalization data from a control.
Public methodEndLoadRepresents the phase after personalization data has been applied to a control.
Public methodEndSaveRepresents the phase after personalization data has been extracted from a control.
Top

This interface allows control developers to track different phases of the personalization life cycle, including the loading and saving of personalization data. In most cases, to use this interface you would create a custom WebPart or WebPartManager and implement this interface. Additionally, controls that need to manage their own change ("dirty") tracking should implement this interface. Controls that manage their own change tracking should return true from the TracksChanges property.

If false is returned, then ASP.NET is responsible for determining changes by comparing the property information loaded with the property information that was saved.

The following code example demonstrates using ITrackingPersonalizable methods and properties to track the loading and saving of personalization information. The example consists of two parts, an .aspx page and a file that should be placed in an App_Code subdirectory.

The following code example creates a Web Parts control that allows a user to enter URL information and saves this information for the user.

No code example is currently available or this language may not be supported.

The following .aspx page creates a Web Parts zone and adds the control to the zone. The page also references a login control that you should use to log on individual users so that personalization can be applied.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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