This project is read-only.
Earlier versions documentation can be found here.

After installing R# Settings Manager it will add 'Settings Manager' node to the Resharper 'Options' dialog, under Tools tree node and 'Tools\Manage Settings...' menu item in the 'Resharper' menu.

RSM Options Page

RSM Options Page.png

Available options:
  1. Personal Settings Folder - a folder containing your personal settings files. Please note that this folder is not meant to contain any settings, shared among team members for a specific solution. It should be used for storing your personal settings, for back-up purposes for example. For settings sharing configuration please use the options available at 'Manage Settings' dialog described below.
  2. Default settings file - you can specify which of the availale personal settings files will be loaded by default for solutions without settings sharing configured. Use 'Manage Settings' dialog to create\edit personal settings files.

'Manage Settings...' menu item

Manage Settings Menu Item.png

Clicking on 'Manage Settings...' menu item will display the Manage Settings Dialog.

Manage Settings Dialog.png

The dialog contains a list of files in the specified personal settings folder and all available shared settings files for the current solution (only available if a solution was loaded).
Available options:
  1. Add drop-down - creates new settings file and displays Settings File Options Dialog described below.
    1. Personal Settings button - creates new personal settings file with the specified name at the personal settings folder, configured at the RSM options page.
    2. Solution Settings - creates new solution settings file with the name of the currently loaded solution at the solution folder. The file will be loaded by the current solution only, i.e. it won't be available for other solutions at the same folder. See Configuring Settings Sharing section for details.
    3. Global Settings - creates new global settings file at the specified location. Global settings files can be used to share settings across multiple solutions located at the global settings file folder and sub-folders. See Configuring Settings Sharing section for details.
  2. Remove button - removes the selected settings file.
  3. Update R# Settings button - updates the selected setting file with the current Resharper configuration.
  4. Load R# Settings button - loads the settings from a selected file. Clicking the 'Advanced...' menu item will show the 'Load Settings Options' dialog described below.
  5. Configure button - displays Settings File Options Dialog described below.

Settings File Options Dialog

Settings File Options Dialog.png

The content of this page is only available if you have a solution opened.

Available options:
  1. Update Common settings automatically - If checked the settings file will be automatically updated with common settings changes (spell-check dictionaries, abbreviation lists and etc) each time the solution is closed. All other settings (Code style, Inspection Severity and etc) will remain unchanged.
  2. Clear read only flag on file updates (TFS compatibility) - If checked, the read-only flag will be removed from the settings file each time the file gets updated.
  3. Store R# settings in an external file - Allows you to specify an external settings file path with the actual R# settings.
  4. Absolute path - Changes the external settings file path to absolute.
  5. Stored ReSharper Settings - Defines which of the available R# settings will be stored in the file. See Configuring Settings Sharing section for details.
    1. Configure button - Displays the selected settings group options dialog. Enabled, if the selected settings group has additional options.

Available Settings Groups
Most of the settings below can be found at 'VS Main Menu\ReSharper\Options...'.
  1. Agent Johnson Introduce String Constant Settings. Available at 'R# Options\Languages\C#\Agent Johnson Settings\'.
  2. Agent Johnson Settings. Available at 'R# Options\Languages\C#\Agent Johnson Settings\'.
  3. Code Annotation Settings. Available at 'R# Options\Code Inspection\Code Annotations'.
  4. Code Cleanup Settings. Available at 'R# Options\Tools\Code Cleanup'.
  5. Code Style Settings. Available at 'R# Options\Languages\C#', 'R# Options\Languages\Visual Basic .NET', 'R# Options\Languages\XML', 'R# Options\Languages\ASP.NET' and 'R# Options\Languages\XAML'.
  6. Highlighting Settings. Available at 'R# Options\Code Inspection\Settings' and 'R# Options\Code Inspection\Inspection Severity'. Has additional options dialog, allowing to force enable Code Analysis and\or Solution-Wide Code Analysis.
  7. Required Products Versions Settings. If enabled, will save the list of selected (at the additional options dialog) R# plug-ins and their versions and the installed R# version. When loading a solution with this feature enabled, RSM will check the availability and versions of the specified products and will notify if a product is outdated or missing (disabled).
  8. Shared Templates. Available at 'R# Menu\Live Templates...\Shared Solution Templates'.
  9. Solution Files\Folders Analysis Settings. Available at 'R# Options\Code Inspection\Settings\Edit Items to Skip' and 'R# Options\Code Inspection\Generated Code'.
  10. Todo Items Settings. Available at 'R# Options\Tools\To-do Items'.

Load Settings Options Dialog

Load Settings File Options Dialog.png

In the check-box list you can specify which settings to load from the selected file. This might be helpful if you need to update the specific configuration section from the chosen file.

Configuring Settings Sharing

When working with multiple solutions it is sometimes needed to adjust a portion of R# configuration for a single solution and\or a group of solutions. In previous releases you could achieve that by creating a solution settings file, but that created a separate file for a single solution. You could also move those solutions to a separate folder and create a shared settings file at that folder. Both approaches created new settings files making it difficult to maintain base R# configuration across all your solutions.

Starting from v4.0 RSM introduces new model of settings sharing, making it possible to define several shared settings files at different folder levels and configure which settings should be loaded by each file. Whenever you load a solution, RSM will first try to locate the corresponding solution settings file, then it will start inspecting the current folder and all parent folders for global settings. This way RSM may locate several settings files available for the current solution and will load them one by one, taking into account which settings groups were already loaded. For example, you can create a global settings file at the root project folder with default R# configuration and a solution settings file or a global settings file located at a sub-folder, containing only highlighting settings. RSM will first find the file with highlighting settings and load it, then it will locate the root settings file and load the remaining settings. This way you can override any part of R# configuration based on your requirements.

Assigning 'Manage Settings' Dialog Shortcut

You can assign a shortcut in VS Tools\Options dialog as shown below:

Assigning Shortcut.png

Last edited Apr 15, 2011 at 2:40 PM by 4uxnbIx, version 19


No comments yet.