ReSharper 2016.1 Help

Automatic completion

ReSharper's automatic completion suggests names of classes, methods, variables, keywords, and any other symbols that are available within the current visibility scope including extension methods that were previously imported. Many other context-specific suggestions, like live templates, code generation suggestions, unit test categories are also available in the completion list.
By default, suggestions of automatic completion also include items from Smart Completion and Import Symbol Completion. If you want to change the default behavior, use the corresponding controls on the Environment | IntelliSense | Completion Behavior options page The list of suggestions is the same as that of Basic Completion.

The suggestion list of the automatic completion appears as soon as you start typing. As you type, the list narrows down to show only items that match what you have entered.

By default, automatic completion support CamelHumps, i.e. you can type the initial letters of a compound name parts and the name will appear in the list of suggestions.
If necessary, you can disable CamelHumps by clearing the Match middle of identifiers check box on the Environment | IntelliSense | Completion Behavior options page.

Note that in most contexts, ReSharper tries to figure out which suggestion you will likely choose, and preselects it in the list. With the default settings, ReSharper inserts the selected item when you press Enter, Space or any non-alphanumeric character.
This may be confusing in the beginning, but there are ways to change the default behavior. First, you can choose not to preselect the guessed item as described below in this topic. Second, you can specify the characters on which the selected suggestion is inserted or not inserted. To do so, use the corresponding controls on the Environment | IntelliSense | Completion Characters options page.

Configuring automatic completion

Automatic completion suggestions only appear if either ReSharper or Limited ReSharper IntelliSence and the corresponding language is selected in the Environment | IntelliSense | General options page.

Automatic completion suggestions only appear if Enable Automatic IntelliSense Popup is checked on the Environment | IntelliSense | Autopopup options page.

On the Environment | IntelliSense | Autopopup options page, you can also tune the behavior of automatic completion for each language and context separately.

For each language and context combination, you can specify one of three kinds of behaviour:

  • Do not display
  • Display and preselect
    When the suggestion list appears, ReSharper tries to guess what are you about to type and selects it for you in the list. If the proposed item is correct, just hit Enter or any non-alphanumeric character to go on with the suggested item. (See ReSharper Options | Environment | IntelliSense | Completion Characters to learn how to configure the insertion of the selected completion item.)
  • Display but do not preselect
    This option just allows the pop-up to show the list of available items without selection so that you could choose one manually. When you hit Enter or any non-alphanumeric character the popup disappears and you can continue with what you've typed. However, the expected item in the pop-up is still highlighted with a blue frame, and if you see that the guess is correct, you can hit Ctrl+Enter to insert it.

For example, you can define the behavior after typing a dot in C# files.

Tuning the behavior of ReSharper's automatic completion

At the examples below you can see the effect of each setting.

Configuring_Code_Completion__autopopup_behaviour

Examples of automatic completion

You can use the following examples to get an idea of how Basic Code Completion works with various code items:

Suggesting type-based variable names

Commonly used names for fields and variables are suggested depending on their type. After entering the type of a variable, press Ctrl+Space. The look-up list displays the suggested names:

Coding_Assistance__Code_Completion__Symbol__01

If you enter a variable name prefix, ReSharper will append it to each suggested name:
Coding_Assistance__Code_Completion__Symbol__02

You can specify a prefix and/or a suffix for all new variable names in Options | Code Editing | C# | C# Naming Style. If you do that, completion items will be modified accordingly:
Coding_Assistance__Code_Completion__Symbol__06

Suggesting members of a class

Coding_Assistance__Code_Completion__Symbol__03

Suggesting visible types

Coding_Assistance__Code_Completion__Symbol__04

Suggesting C# keywords

Coding_Assistance__Code_Completion__Symbol__05

Suggesting 'this' keyword for static methods in static classes

Coding_Assistance__Code_Completion__Symbol__this

Completion for Enum Members

Coding_Assistance__Code_Completion__Symbol__enum_members_01
Coding_Assistance__Code_Completion__Symbol__enum_members_02

Basic Completion using CamelHumps

Coding_Assistance__Code_Completion__Symbol__07

Completion for unresolved symbols

Early used names of data types and their members are suggested, even if they are not declared anywhere in the code and cannot be resolved.

Coding_Assistance__Code_Completion__Symbol__unresolved

Completion for argument names

Coding_Assistance__Code_Completion__Argument_names

Suggesting members of a dynamic type

Coding_Assistance__Code_Completion__Dynamic_members

Suggesting existing partial classes

When you type partial class, names of partial classes in the current scope are added to the suggestions list, thus helping you to quickly create new parts of existing partial classes.

Suggestions for existing partial classes in ReSharper code completion

Applicability in different languages

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 feature_available feature_available feature_available feature_available feature_available feature_available feature_available 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.

Last modified: 19 August 2016