The personalization attribute, Personalizable, is applied to public control properties that need to persist personalization information. ASP.NET automatically generates the code to persist or retrieve these values from the underlying data store when the control is in a Web Parts zone on a Web Parts page.

The following requirements must be met for a property to be marked as personalizable:

• The property must be public and must have public get and set accessors.

• The property must be a read/write property.

• The property must be without parameters.

• The property cannot be indexed.

Code is automatically generated to load and save personalization data for properties. Properties that support personalization are determined based on the existence of this attribute on the property and the fact that the property conforms to the constraints listed above.

Note that read-only and write-only properties are not supported for personalization. Applying this attribute to a read-only or write-only property results in an System.Web.HttpException being thrown. Parameterized properties also throw an System.Web.HttpException exception.

Individual properties without this attribute are excluded from personalization if no special handling through the System.Web.UI.WebControls.WebParts.IPersonalizable interface is used.

For more information about using attributes, see Web Parts Personalization.