Skip to main content

DataViewBase.SearchStringToFilterCriteria Event

Occurs each time the GridControl starts to search data and allows you to convert the search string to filter criteria.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v22.2.Core.dll

NuGet Package: DevExpress.Wpf.Grid.Core


public event SearchStringToFilterCriteriaEventHandler SearchStringToFilterCriteria

Event Data

The SearchStringToFilterCriteria event's data class is SearchStringToFilterCriteriaEventArgs. The following properties provide information specific to this event:

Property Description
ApplyToColumnsFilter Gets or sets whether the column’s filter popup detects changes in the search panel.
Filter Gets or sets the filter that is applied to the GridControl.
Highlighting Gets or sets highlighting strings for fields.
SearchString Gets the search string entered in the Search Panel.
Source Gets the GridControl.


The following code sample shows how to make the Search Panel search for a string that contains a space character without the need to specify this string in quotation marks:

Data Grid - SearchStringToFilterCriteria Event

        SearchString="Alex Mercer"
void TableView_SearchStringToFilterCriteria(object sender, SearchStringToFilterCriteriaEventArgs e) {
    e.Filter = CriteriaOperator.Parse(string.Format("Contains([Name], '{0}')", e.SearchString));

View Example: How to Search a String with Spaces


If you handle the SearchStringToFilterCriteria event and do not specify the SearchStringToFilterCriteriaEventArgs.Filter property, the GridControl does not search items.

Refer to the following help topic for more information: Search.

The following code snippets (auto-collected from DevExpress Examples) contain references to the SearchStringToFilterCriteria event.


The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also