ReSharper 2016.1 Help

Using Filters in Code Completion

ReSharper allows you to filter completion suggestions by kind of symbol, access modifiers, etc. You can modify the set of applied filters each time the code completion is invoked and/or choose to keep the state of filters.

By default, ReSharper shows filters bar in the bottom of the completion pou-up. In this bar, you can see the state of filters and click on the icons to enable or disable specific filters.

Filters in completion pop-up

If necessary, you can hide the filters bar and configure other related options in the Environment | IntelliSense | Completion Filters page of ReSharper options.

In this topic:

Persisting state of filters

By default, completion filters you specify are reset each time you invoke code completion. If necessary, you can keep the last modified state of filters. To do so, select Persist filters on the Environment | IntelliSense | Completion Filters page of ReSharper options.

When this check box is selected, you can optionally modify the default state of filters. Note that these filter state controls are synchronized with the filter bar in the completion pop-up.

Filter modes

Each filter can be enabled in one of two modes: inclusive or exclusive.

Inclusive mode

if a filter is enabled in this mode, the completion list only shows items that match this filter. If there are several filters enabled in this mode, the completion list shows items that match all of these filters.

To enable filters in this mode, left-click on the filter icon.

On the filter bar, filters in this mode are highlighted with the uniform background.

Exclusive mode

if a filter is enabled in this mode, the completion list only shows items that match this filter. If there are several filters enabled in this mode, the completion list shows items that match all of these filters.

To enable filters in this mode, right-click on the filter icon.

On the filter bar, filters in this mode are highlighted with the border.

Custom filters

ReSharper allows you to define custom filters that you can use to exclude items by their assembly, namespace, and other parameters from completion suggestions.

To define a custom completion filter

  1. Open the Environment | IntelliSense | Completion Filters page of ReSharper options.
  2. Make sure that the Enable Filters check box is ticked.
  3. Click Add on the bottom of the page and choose CLR Symbols Filter
  4. In the Custom Filter Configuration dialog box that opens specify filter details:
    • Specify one or more masks for the symbol.
    • Optionally, select a kind of symbols to be matched.
    • Choose whether to match types with or without type parameters.
  5. Click OK to add the filter and close the dialog box. The new filter appears in the Custom Filters area. If necessary, you can modify the filter later.
  6. Click Save to apply the modifications and let ReSharper choose where to save them, or save the modifications to a specific settings layer using the Save To drop-down list. For more information, see Managing and Sharing ReSharper Settings.

This feature is supported in the following languages/technologies:

C# VB.NET C++ HTML ASPX Razor JavaScript TypeScript CSS XML XAML RESX Build Scripts Protobuf JSON
feature_available feature_available feature_available feature_available

The instructions and examples given here address the use of the feature in C#. For details specific to other languages, see corresponding topics in the ReSharper by Language section.

See Also

Last modified: 19 August 2016