AppearanceEditorPart.SyncChanges Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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
Available since 2.0
Return to top
Show: