BackwardCompatibilitySettings.ListEditEnableSynchronizationDefaultValue Property

Gets or sets a value that specifies whether client manipulations with the list editor items (adding, deleting) should be synchronized with the editor’s server Items collection.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v21.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

public bool ListEditEnableSynchronizationDefaultValue { get; set; }

VB.NET

Public Property ListEditEnableSynchronizationDefaultValue As Boolean

Property Value

Type	Description
Boolean	true to enable list editors’ items synchronization; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ListEditEnableSynchronizationDefaultValue
ASPxWebControl	.BackwardCompatibility .ListEditEnableSynchronizationDefaultValue

Remarks

If the ASPxEditBase.EnableClientSideAPI property is set to true, you can manipulate the list editor items on the client side by using specific client methods (such as AddItem, RemoveItem, etc). The list editor’s EnableSynchronization property controls whether such client item manipulations should be synchronized with the list editor’s server Items collection.

Note

List editors must have its Items collection bound by the time synchronization occurs. So, you should provide the list editors with items using the Init or Page_Init event handler.

Note that the synchronization does not modify a data source, so you should do it manually to prevent losing your data.

Note that if the EnableSynchronization property is set to Default, the item synchronization’s availability depends upon the ListEditEnableSynchronizationDefaultValue property setting: if it is set to true, the item synchronization is available; otherwise, it is disabled.

The following example illustrates how to enable items synchronization for all list editors.

Global.asax:

C#

void Application_Start(object sender, EventArgs e) {
        ASPxWebControl.BackwardCompatibility.ListEditEnableSynchronizationDefaultValue = true;
    }