A newer version of this page is available. Switch to the current version.

ASPxAutoCompleteBoxBase.TextFormatString Property

Gets or sets the pattern used to format the selected item's text displayed in the editor's edit box.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll


public virtual string TextFormatString { get; set; }
Public Overridable Property TextFormatString As String

Property Value

Type Default Description


A string value that represents the format pattern.


The TextFormatString property is in effect if the editor is used in multi-column mode. In this mode, the editor's selected item is represented within the editor's edit box using a text value whose format is based upon the TextFormatString property's setting.

By default, the TextFormatString property is set to an empty string. In this case, the selected item is represented within the editor's text box by the values of all visible columns. The order of column values in the text box directly corresponds to the visible order of columns within the editor's dropdown window and correlates with the order in which columns are listed within the editor's ASPxComboBox.Columns collection. Column values are separated with a default separator represented by a semicolon and white space symbols.


You can use the TextFormatString property to provide a custom format for the selected item's value displayed within the editor's edit box. Set the property's value by using indexed placeholders (such as "{0}", "{1}", etc.), which can be combined with fixed literals. Pl