Export (0) Print
Expand All

AppearanceEditorPart.SyncChanges Method

Retrieves the property values from a WebPart control and assigns them to the associated AppearanceEditorPart control.

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

public override void SyncChanges()

The SyncChanges method is a critical method on an AppearanceEditorPart control. It implements the EditorPart.SyncChanges method from the base class, retrieves the current values from the associated WebPart control, and updates the controls in the AppearanceEditorPart control with those values so a user can edit them.

The SyncChanges method is called whenever the values in the associated WebPart control might have changed. For an AppearanceEditorPart control, the EditorZoneBase zone that contains the control calls the SyncChanges method, so that the values in the AppearanceEditorPart control are always synchronized with the values in the associated WebPart control. Another case where the SyncChanges method is called is when a WebPart control is entering edit mode.

Notes to Inheritors

The Web Parts control set calls the SyncChanges method within the inherited OnPreRender method, so that if any changes occurred after the user last viewed the control prior to editing (for example, a shared administrative user made changes to the control that would affect all users), those changes would be evident during the editing process.

If you create a custom control, you can follow the same approach, and call the SyncChanges method from the inherited OnPreRender method to ensure that any intervening changes are synchronized, but it is not necessary to do this.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft