ReSharper 2017.2 Help

First Steps with ReSharper

ReSharper is ready to use right after installation. When you run Visual Studio after installation of ReSharper, you need to specify your license information and then get started.

For new users, ReSharper offers a 30-day free evaluation period. During this period, you can enjoy full functionality of the product and decide whether it suits your needs. The evaluation period can be paused and resumed with the Pause/Resume Evaluation button in the License Information dialog. During the evaluation period you will be able to see how many days are left.

This topic will help you quickly get started with ReSharper, learn how and where to find its commands, and get familiar with its most frequently used features.

The first step

ReSharper is a keyboard-centric product. Most of its actions have default keyboard shortcuts and if necessary, you can assign a custom shortcut to any of its commands.

Therefore, right when ReSharper is ready, it prompts you to choose one of the two default keyboard shortcut schemes:

Choosing ReSharper keyboard shortcuts scheme

You can change the selected scheme later using the corresponding selector on the Environment | Keyboard & Menus page of ReSharper options.

For more information, see Configuring Keyboard Shortcuts

Looking around

When ReSharper is installed in Visual Studio, you will see the following changes:

  • The ReSharper menu that appears in Visual Studio menu bar, contains all commands except those that are only available in context, e.g. context actions or quick-fixes.
    ReSharper menu in Visual Studio
    Note that the Cover and Profile submenus only appear if JetBrains dotCover and JetBrains dotTrace are installed together with ReSharper.
  • A number of tool windows that appear after specific commands. All ReSharper tool windows are also available in the ReSharper | Windows menu.
  • ReSharper's commands are available in the context menu of the editor, Solution Explorer and other Visual Studio windows.
    Note that by default, ReSharper also hides overridden Visual Studio items (e.g. refactoring and navigation commands) in these menus. If you want to preserve the original Visual Studio menu items, clear the Hide overridden Visual Studio menu items check box on the Environment | Keyboard & Menus page of ReSharper options.
  • ReSharper page in Visual Studio options that allows you to suspend and resume ReSharper at any time. Normally, you do not need to do this. However, if you experience performance problems when working with large solutions, suspending ReSharper may help improve the performance.
  • A lot of changes in the editor and the status bar:
    ReSharper features in Visual Studio editor
    1. Status indicator that helps you to see at once whether the current file has errors or warnings.
    2. A fix pop-up that appears for non-imported types. It is enough to press Alt+Enter or click on this pop-up and ReSharper will add the missing directive for all types in the file. For more information, see Importing Missing Namespaces.
    3. A low-priority code issue (in this case, a suggestion related to an unused public member) is greyed out.
    4. A medium-priority code issue (in this case, a warning about a symbol name that does not fit with the naming style) is highlighted with a blue curly underline.
    5. A marker corresponding to the suggestion issue (3) is displayed on the marker bar.
    6. A marker corresponding to the error issue (8) is displayed on the marker bar.
    7. An action indicator that appears to the left of the caret position if ReSharper has anything to suggest there.
    8. A high-priority code issues (in this case, errors related to an unresolved symbol and an incorrect return type) are highlighted with red text and red curly underline.
    9. A marker corresponding to the warning issue (4) is displayed on the marker bar.
    10. The action list, which opens by pressing Alt+Enter or clicking the action indicator (7), contains a list of quick-fixes for the issue at the caret.
    11. A short description of the issue at the caret appears in the status bar. You can also view descriptions of code issues by hovering the mouse over highlighted code or over the issue markers on the marker bar (5,6,9)
    12. If the solution-wide analysis is enabled, ReSharper allows you to see even more code issues. In this example, it detects the unused public member (3) and notifies about errors in other files of your solution. You can click on the solution-wide analysis icon to explore the detected issues.
  • You can also use the Quick Launch box to find and execute ReSharper commands:
    ReSharper commands in the Quick Launch box

ReSharper provides a lot of navigation and search features. Let's get familiar with some of them.

Jumping to declaration

Press the Ctrl key and hover the mouse over your code. You will see that all symbols defined elsewhere become underlined when in focus. You can click any symbol while holding down the Ctrl key to navigate directly to its declaration. If the symbol is defined in the current solution, ReSharper opens the corresponding file and brings the caret to the declaration. If the symbol is defined in a compiled library, ReSharper opens it according to your preferences.

Go to Declaration with Ctrl+click
For more information, see Go to Declaration.

Finding usages

To navigate in the opposite direction, i.e. to find all places in your solution where the symbol is used, press Alt+F7. ReSharper will quickly find and display all usages of the symbol. For more information, see Finding Usages.

Checking available navigation actions

Another handy navigation shortcut is Ctrl+Shift+G. When you press it on any symbol, ReSharper will show you all available navigation options:

Navigate To
For more information, see Navigate To.

Finding anything in your solution

If you need to find anything in your solution, press Ctrl+N. The list of suggestions appears as soon as you invoke this feature and initially includes your recent files and navigated items. You can start typing to find types, symbols, files, recent edits, recent files, and recently viewed methods. For more information, see Go to Everything/Type.

Locating current file in the solution tree

When a navigation command brings you to a new file, you may want to see where it is in the Solution Explorer. Just press Shift+Alt+L and the Solution Explorer will scroll to the current file and highlight it. For more information, see Locating Current Document in Solution/Assembly Explorer

Coding in the editor

When you are working in the editor, a bunch of code editing helpers are at your hand. Here are a couple of them.

Code completion (IntelliSense)

ReSharper complements and extends Visual Studio's native code completion (IntelliSense) with more advanced capabilities. For example, it narrows down the list of suggestions based on your typing, automatically imports selected types and extension methods, adds parentheses when completing method names, suggests variable and field names depending on their types, and so on.

Completing interface name with CamelHumps

If necessary, you can always go back to the native Visual Studio IntelliSense by choosing the corresponding option on the Environment | IntelliSense | General page of ReSharper options.

Regardless of your preference for automatic completion, you can always invoke ReSharper's code completion features explicitly, either after you have typed something or even instead of typing, wherever any meaningful code is allowed:

  • Pressing Ctrl+Shift+Space invokes the smart completion that provides more intelligent suggestions based on the expected type of the expression.
  • Pressing Ctrl+Alt+Space invokes the import symbol completion that displays all types that match a given prefix regardless of what namespace they belong to, It also inserts appropriate namespace import directives to the current file if necessary.

Selecting and moving code blocks

Wherever your caret is, try pressing Ctrl+W / Ctrl+Shift+W. These shortcuts allow you to successively select a symbol, line, or block of code so that you can easily select any desired expression for copying, cutting, or moving. For more information, see Extend/Shrink Selection.

If you need to move the selected code block, press Ctrl+Shift+Alt and then use the arrow keys to move the block to any allowed position. For more information, see Rearranging Code Elements

The power of Alt+Enter

Very often you will see one of many different action indicators in the left part of the editor. You can press Alt+Enter to see what ReSharper has to suggest at the current caret position:

Action list

Here are a couple of examples:

  • If you see a red bulb /help/img/dotnet/2017.2/ThemedIcon.RedBulb.Screen.[Gray].png or a yellow bulb /help/img/dotnet/2017.2/ThemedIcon.YellowBulb.Screen.[Gray].png icon it is even recommended to press Alt+Enter because these action indicators tell you that ReSharper has detected an error or other code issue and it knows how to fix it.
  • If you see a hammer /help/img/dotnet/2017.2/ThemedIcon.ContextAction.Screen.[Gray].png icon, you can ignore it unless you want to modify code at the caret. If you want to make changes, pressing Alt+Enter may be helpful. ReSharper provides hundreds of context actions that can, for example, quickly change symbol visibility, add code that iterates over a collection, and more.
  • You can also press Alt+Enter if there are no action indicators in view. In this case, you can start typing to quickly find and execute any ReSharper action in scope.
    Navigating to action

Refactoring code

ReSharper's set of refactorings by far surpasses that provided by Visual Studio, with regard to number, usability and scope of application.

It is not easy to learn and remember each of several dozens refactorings that ReSharper provides. However, you can press Ctrl+Shift+R on any symbol in your code and check out which refactorings are available here.

Generating code

ReSharper can help you concentrate on non-trivial tasks by providing a lot of features for generating boilerplate code automatically. For example, you can call a non-existent method and ReSharper will create this method based on the usage, taking into account the return type and the types of parameters.

Generating type members

When your caret is anywhere within a type declaration, press Alt+Insert. In the pop-up menu that opens, you can select an item that you want to generate for the type. ReSharper can create constructors, properties, overriding members, and more. For more information, see Code Generation.

Generating type members with ReSharper

Applying code templates

When you are about to write a typical code block, such as 'for' or 'foreach' loop, a safe type cast, an assertion, etc., press Ctrl+J and choose the corresponding live template instead. For more information, see Creating Source Code Using Live Templates.

Selecting a live template

Using a similar technique, you can surround existing code blocks with typical code constructs, such as 'if...else', 'try...catch', etc. In this case, press Ctrl+Alt+J or Alt+Enter over the selection. For more information, see Surrounding Code Fragments with Templates.

Surrounding a code block with a template

If you find ReSharper's code templates useful, you may be also interested in adding new files form templates and creating your own code templates.

Code style matters

With ReSharper, you can control the most of style aspects in your code: naming standards, formatting rules, file and type layout, file header style, and many other tiny things (such as order of modifiers or whether to use the 'var' keyword).

The default values of ReSharper code style features are selected based on Microsoft guidelines and numerous best practices. At the same time, each tiny aspect of code style can be changed to fit your personal or corporate preferences.

To apply code style rules, press Ctrl+Alt+F. ReSharper will prompt you to choose one of the two default code cleanup profiles: either reformat the code or apply multiple code style rules in the selected scope.

What's next

You can check out the ReSharper Workshop on GitHub. This is a Visual Studio solution that provides step by step code exercises for navigation, editing, inspections, refactoring and more.

Last modified: 20 October 2017

See Also