[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Collapse]Office File API
  Demo Application
  Redistribution and Deployment
 [Collapse]Spreadsheet Document API
   Product Structure
   Getting Started
  [Expand]Spreadsheet Document
   Supported Formats
  [Expand]Cell Basics
  [Expand]Formulas
   Defined Names
   Data Binding
  [Expand]Pivot Tables
  [Expand]Charts and Graphics
  [Expand]Mail Merge
  [Collapse]Examples
   [Expand]Files
   [Expand]Workbooks
   [Expand]Worksheets
   [Expand]Rows and Columns
   [Expand]Cells
   [Expand]Formulas
   [Expand]Import and Export Data
   [Expand]Data Binding
    Sorting
   [Expand]Mail Merge
    Search
   [Expand]Shapes
   [Expand]Charts
   [Expand]Sparklines
   [Expand]Formatting Cells
   [Expand]Conditional Formatting
   [Expand]Group Data
   [Collapse]Filter Data
     How to: Enable Filtering
     How to: Filter by Cell Values
     How to: Filter by Date Values
     How to: Apply a Custom Date Filter
     How to: Apply a Custom Text Filter
     How to: Apply a Custom Number Filter
     How to: Apply a Dynamic Filter
     How to: Filter Top or Bottom Ranked Values
     How to: Sort Data in the Filtered Range
     How to: Reapply a Filter
     How to: Clear a Filter
   [Expand]Tables
   [Expand]Pivot Tables
   [Expand]Printing
   [Expand]Pictures
   [Expand]Protection
 [Expand]Word Processing Document API
 [Expand]PDF Document API
 [Expand]Excel Export Library
 [Expand]Snap Report API
 [Expand]Zip Compression and Archive API
 [Expand]Barcode Generation API
 [Expand]Unit Conversion API
 [Expand]API Reference
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

How to: Apply a Custom Text Filter

This example demonstrates how to specify the custom compound filter criteria to filter text values in a column.

  1. Turn on the filtering functionality for the required range, as described in the How to: Enable Filtering example.
  2. Use the AutoFilterBase.Columns property of the SheetAutoFilter object to get a collection of columns in the filtered range (the AutoFilterColumnCollection object). Each column in the collection is defined by the AutoFilterColumn object, which provides basic methods for data filtering. To filter data in a particular column, get access to this column by its index in the AutoFilterColumnCollection collection.
  3. To apply a custom complex filter, call the AutoFilterColumn.ApplyCustomFilter method overload with five parameters.

    • Specify the first filter criterion. To perform text filtering, use the wildcard characters. The asterisk * matches any number of characters, while the question mark ? represents a single character. For example, to display all the products that contain the two-letter combination "Gi" in their names, specify the "Gi" string as the filter criterion value, and use the FilterComparisonOperator.Equal member of the FilterComparisonOperator enumeration as the comparison operator.

      Tip

      To filter values containing a specific character, such as the asterisk, question mark or tilde, put the tilde (~) before it.

    • Specify the second filter criterion. To include blank cells in the filtering results, use the value of the FilterValue.FilterByBlank property as the second criterion value, and select the FilterComparisonOperator.Equal comparison operator.
    • Pass the false value as the last parameter of the method to indicate that the OR operator should be used to combine the filter criteria specified above.

Is this topic helpful?​​​​​​​