AutoCompleteBoxPropertiesBase.EnableSynchronization Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
public DefaultBoolean EnableSynchronization { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
Public Property EnableSynchronization As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	**Default**	One of the DefaultBoolean enumeration values.

Available values:

Name	Description
True	Corresponds to a Boolean value of true.
False	Corresponds to a Boolean value of false.
Default	The value is determined by the current object’s parent object setting (e.g., a control setting).

Remarks

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

Note

An ASPxComboBox must have its ASPxAutoCompleteBoxBase.Items collection bound by the time synchronization occurs. So, you should provide the ASPxComboBox with items using its 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.

If the EnableSynchronization property is set to DefaultBoolean.Default, the item synchronization availability depends upon the ASPxAutoCompleteBoxBase.EnableCallbackMode property setting. If ASPxAutoCompleteBoxBase.EnableCallbackMode is set to DefaultBoolean.False, the item synchronization is available; otherwise, it is disabled.

If the EnableSynchronization property is enabled and the ASPxAutoCompleteBoxBase.DataSecurityMode property is set to the Default value, a list editor allows adding new list items via client code and synchronizes modifications to this list with the server ASPxAutoCompleteBoxBase.Items collection. In this scenario, it is recommended to HTML encode the editor item’s content using the following:

• enable the EditPropertiesBase.EncodeHtml property if items aren’t created using templates.

• encode HTML using the HttpUtility.HtmlEncode method if items are created using templates (ASPxAutoCompleteBoxBase.ItemTemplate).

  ASPX

  
  <dx:ASPxComboBox ID="cb1" runat="server">
      <ItemTemplate>
          <asp:Label ID="Label1" runat="server" Text='<%# HttpUtility.HtmlEncode(Eval("Text")) %>'></asp:Label>
      </ItemTemplate>
  </dx:ASPxComboBox>
  

Note that the item synchronization is disabled if the ASPxAutoCompleteBoxBase.EnableCallbackMode property is set to true.

Note

The EnableSynchronization property synchronizes its value with the editor’s ASPxAutoCompleteBoxBase.EnableSynchronization property.