This documentation is archived and is not being maintained.

CatalogZoneBase::SaveControlState Method

Saves any changes in a CatalogZoneBase control's state that occur after the Web page is posted back to the server.

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

protected public:
virtual Object^ SaveControlState() override

Return Value

Type: System::Object
An Object that contains the state data for the control. If there have been no changes to the state, the method returns nullptr.

The SaveControlState method is concerned with state data that is essential for a control's operation (such as an index or keyword) and is separate from the control's view-state data.

The method first calls the base method to save the existing state data for the control. Next, it determines whether a CatalogPart control in the zone is currently selected, by checking whether the SelectedCatalogPartID property has a value. If there is a selected control, the method updates the existing state data with the state data from the selected control, and then returns all the state data.

Notes to Inheritors

You can optionally override the SaveControlState method in a derived class so that you can update the saved control state for other custom objects in the zone.

.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: