ReSharper Web Help

Since ReSharper 6.1 unified storage mechanism is used 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.

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.

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.

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 add a new layer
  1. On the main menu, choose ReSharper | Manage Options. The Settings Layers dialog opens.
  2. Do one of the following:
    • Depending on what kind of layer should be added, select one of default layers. Click Add Layer , then click New Layer.
    • Depending on what kind of layer should be added, right-click one of default layers. Click Add Layer on the context menu, then click New Layer.
    The Save As dialog opens.
  3. Type a new name for the layer in the File name 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 opens.
  2. Do one of the following:
    • Depending on what kind of layer should be added, select one of default layers. Click Add Layer , then click Existing Layer.
    • Depending on what kind of layer should be added, right-click one of default layers. Click Add Layer on the context menu, then click Existing Layer.
    The Open dialog opens.
  3. Browse for a file, then select it or start typing its name in the File name 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 edit a layer
  1. In the Settings Layers dialog, select a layer to be edited.
  2. Do one of the following:
    • Click Edit Layer .
    • Right-click, then click Edit on the context menu.
    • Double-click the desired layer.
  3. The Options dialog 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.

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. Within each group, for example solution personal, the first layer overrides those that lie below it. To change the priorities, move layers.

To move a layer
  1. In the Settings Layers dialog, select a layer to be moved.
  2. Click Move up or Move down depending on your goal.
To import settings
  1. In the Settings Layers dialog, select a layer where settings should be added.
  2. Do one of the following:
    • On the toolbar, click Import/Export Settings . 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 imported file.

     Note

    Pay attention, that you cannot enter URL based on HTTP protocol.
  4. The Import from File dialog 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 export settings
  1. In the Settings Layers dialog, select an existing layer to be exported to a file.
  2. Do one of the following:
    • On the toolbar, click Import/Export Settings , then click Export to File.
    • Right-click the layer, then click Export to File on the context menu.
  3. The Export to File dialog 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 box.
  6. Optionally, change the type using the Save as type list.
  7. Click Save to complete the export operation.
To copy settings from one layer to another
  1. In the Settings Layers dialog, select a layer which settings are to be copied.
  2. Do one of the following:
    • On the toolbar, click Copy Settings 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.
    To see all available layers in a separate dialog, click Show All Layers. The Copy Settings from Layer to Layer dialog opens. Find the one you need and click it, then click Copy.
  3. The Copy To dialog 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 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.

See Also

Procedures

Reference

External Links