ReSharper 8.0 Web Help

ReSharper provides a unified storage mechanism to store all settings.

ReSharper maintains a number of settings layers. Each layer can be either global or solution specific. It can be either personal or shared with team members.

ReSharper applies settings by combining them from each layer. By default, ReSharper provides three layers:

  • Solution personal
  • Solution team-shared
  • This computer

Solution personal

This layer contains settings that apply to the current solution only and that are not shared with other team members. These settings are stored in SolutionName.sln.DotSettings.user in the solution folder. This file should not be added into version control system. In order to save changes into this layer, click Save To, then click Solution [solution name] personal in the Options dialog box.

Solution team-shared

This layer contains settings that apply to the current solution and that are shared with other team members. These settings are stored in SolutionName.sln.DotSettings in the solution folder. This file should be put under version control to make it available for all team members. For instance, that helps to have unified coding standards for the whole development team. Whenever this file is changed externally, all changes are immediately applied. In order to save changes into this layer, click Save To, then click Solution [solution name] team-shared in the Options dialog box.

This computer

This layer contains settings that apply to any solution opened on the local machine. All settings are stored in AppData\JetBrains\ReSharper\vAny\GlobalSettingsStorage.DotSettings. In order to save changes into this layer, click Save To, then click This computer in the Options dialog box.

Personal configuration options include (but are not limited to):

  • Code formatting settings.
  • To-do patterns and filters.
  • Code cleanup settings.
  • Namespace import settings.
  • ReSharper templates.
  • Code completion settings.

See Sharing Templates for additional guidelines on creating shared templates.

To create a new layer
  1. On the main menu, choose ReSharper | Manage Options. The Settings Layers dialog box opens.
  2. Do one of the following:
    • Depending on what kind of layer should be added, select one of default layers. Click Add Layer Sharing_Configuration_Options__Add_Layer, then click Create Settings File.
    • Depending on what kind of layer should be added, right-click one of default layers. Click Create Settings File on the context menu, then click New Layer.
    The Save As dialog box opens.
  3. Type a new name for the layer in the File name text box.
  4. Optionally, change the type using the Save as type list.
  5. Click Save to actually create the layer and include it into the ReSharper settings.
To include an existing layer
  1. On the main menu, choose ReSharper | Manage Options. The Settings Layers dialog box opens.
  2. Do one of the following:
    • Depending on what kind of layer should be added, select one of default layers. Click Add Layer Sharing_Configuration_Options__Add_Layer, then click Open Settings File.
    • Depending on what kind of layer should be added, right-click one of default layers. Click Add Layer on the context menu, then click Open Settings File.
    The Open dialog box opens.
  3. Browse for a file, then select it or start typing its name in the File name text box.
  4. Optionally, change the type using the Save as type list.
  5. Click Save to include it into the ReSharper settings.
To edit a layer
  1. In the Settings Layers dialog box, select a layer to be edited.
  2. Do one of the following:
    • Click Edit Layer Sharing_Configuration_Options__Edit_Layer.
    • Right-click, then click Edit on the context menu.
    • Double-click the desired layer.
  3. The Options dialog box opens, where all settings defined for the selected layer are displayed. The name of the layer and its location are displayed at the top of the dialog to clarify which layer the settings belong to.
  4. Click Save to save the changes and close the dialog box.

As soon as settings in default layers are modified or if a new layer with non-default settings exists, you should take into account that settings from different layers are combined and a setting value from one layer can override the value of the same setting from another layer. Team-shared settings per solution override settings defined for this computer. And personal settings per solution override team-shared settings.
Sharing_Configuration_Options__Layers
Within each group, for example team-shared, the first layer overrides those that lie below it.
Sharing_Configuration_Options__Custom_Layers
You can change the way settings are applied without changing layers themselves by moving layers up and down.

To move a layer
  1. In the Settings Layers dialog box, select a layer to be moved.
  2. Click Move up or Move down depending on your goal.

If you want to save or share settings, export all of them or some certain groups of them.

To export settings
  1. In the Settings Layers dialog box, select an existing layer to be exported to a file.
  2. Do one of the following:
    • On the toolbar, click Import/Export Settings Sharing_Configuration_Options__Import_Export, then click Export to File.
    • Right-click the layer, then click Export to File on the context menu.
  3. The Export to File dialog box opens, where you specify group(s) of settings to be exported by selecting or clearing corresponding check boxes.
  4. Click OK. The Save As dialog opens.
  5. Type a file name in the File name text box.
  6. Optionally, change the type using the Save as type list.
  7. Click Save to complete the export operation.

If you want to copy a group or groups of settings from a separate file into one of the existing layers, you can do it via settings import.

To import settings
  1. In the Settings Layers dialog box, select the layer where settings should be added.
  2. Do one of the following:
    • On the toolbar, click Import/Export Settings Sharing_Configuration_Options__Import_Export. Depending on the location of the file to be imported, click Import from File or Import from URL.
    • Right-click the layer. Click Import from on the context menu, then click Import from File or Import from URL.
  3. Specify location of the file to be imported. Pay attention, that if you have chosen to import from URL, the path to the file should be specified in UNC format.
  4. The Import from File dialog box opens, where you specify group(s) of settings to be imported by selecting or clearing corresponding check boxes.
  5. Click OK to complete the import operation.
To copy settings from one layer to another
  1. In the Settings Layers dialog box, select a layer which settings are to be copied.
  2. Do one of the following:
    • On the toolbar, click Copy Settings To Sharing_Configuration_Options__Copy_To, then click the target layer name.
    • Right-click the layer, then click Copy Settings To and click the target layer name on the context menu.
  3. The Copy To dialog box opens where you can specify group(s) of settings to be copied by selecting or clearing corresponding check boxes.
  4. Click OK to complete the process.

When something goes wrong and after some experiments the settings do not satisfy your needs, you can disable the corresponding layer or reset the settings and return to the starting point. If you want to reset a particular layer, select the layer and click Reset on the context menu. Moreover, you can reset all settings in all default layers and remove all custom layers with one click. To do that, click Reset All Settings Sharing_Configuration_Options__Reset_All on the toolbar.

Note

When you reset all settings, the files that contain custom layer settings are not physically removed. If you need, you can add them again.