Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DxComboBoxSettings.SearchTextParseMode Property

Specifies how the combo box editor treats search words.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

#Declaration

C#
[DefaultValue(ListSearchTextParseMode.Default)]
[Parameter]
public ListSearchTextParseMode SearchTextParseMode { get; set; }

#Property Value

Type Default Description
ListSearchTextParseMode Default

An enumeration value.

Available values:

Name Description
Default

The ExactMatch is used by default. The search words are not treated separately. Only records that match the search text exactly are shown.

GroupWordsByAnd

The search words are grouped as individual conditions by the AND logical operator. Only records that match all the conditions are shown.

GroupWordsByOr

The search words are treated as individual conditions grouped by the OR logical operator. Records that match at least one of these conditions are shown.

ExactMatch

The search words are not treated separately. Only records that match the search text exactly are shown.

#Remarks

The search feature allows users to locate and highlight the search text in combo box editor data. If the search text contains multiple words separated by space characters, the words can be treated as a single condition or as individual conditions grouped by the Or or And operator.

Use the SearchTextParseMode property to specify how the combo box editor component treats search words.

The following code snippet sets SearchTextParseMode to ExactMatch:

Razor
<DxGrid Data="Products"
        EditMode="GridEditMode.EditRow"
        CustomizeEditModel="Grid_CustomizeEditModel"
        EditModelSaving="Grid_EditModelSaving">
    <Columns>
        <DxGridCommandColumn DeleteButtonVisible="false" Width="15%" />
        <DxGridDataColumn FieldName="ProductName" Width="25%" />
        <DxGridDataColumn FieldName="CategoryId" Caption="Category" Width="10%">
            <EditSettings>
                <DxComboBoxSettings Data="Categories" 
                                    ValueFieldName="CategoryId" 
                                    TextFieldName="CategoryName"
                                    SearchTextParseMode="ListSearchTextParseMode.ExactMatch" />
            </EditSettings>
        </DxGridDataColumn>
        <DxGridDataColumn FieldName="UnitPrice" DisplayFormat="c" Width="10%">
            <EditSettings>
                <DxSpinEditSettings MinValue="0M" Mask="n3" />
            </EditSettings>
        </DxGridDataColumn>
        <DxGridDataColumn FieldName="UnitsInStock" />
        <DxGridDataColumn FieldName="QuantityPerUnit" Width="15%" />   
        <DxGridDataColumn FieldName="Discontinued" />
    </Columns>
</DxGrid>
See Also