ReSharper 2016.1 Help

Encapsulate Field

ReSharper | Refactor | Encapsulate Field…

This refactoring allows you to create an auto-property or a property with the backing filed from an existing field. Usages of the field are updated automatically.

In the example below, a field is replaced with an auto-property:

Before refactoringAfter refactoring
private string myString; public void DoSomething(string input) { myString = input; }
public string MyString { get; private set; } public void DoSomething(string input) { MyString = input; }

To encapsulate a field

  1. Place the caret at the declaration or a usage of a field in the editor, or select it in the File Structure Window.
  2. Do one of the following:
    • Press Ctrl+R,E.
    • Press Ctrl+Shift+R and then choose Encapsulate Field
    • Right-click and choose Refactor | Encapsulate Field on the context menu.
    • Choose ReSharper | Refactor | Encapsulate Field… in the main menu.
    The Encapsulate Field dialog will open.
  3. ReSharper suggests a name for the property based on the field name and the naming style for properties. Modify the name if necessary.
  4. Specify whether to create an auto-property or create a normal property and use the field as its backing field.
  5. By default, ReSharper replaces all (local and external) usages of the field with the property. If you are creating a normal property, you can clear the Do not update local usages check box to leave references to the field in the current type.
  6. Specify the property visibility.
  7. If you are creating a normal property, you can tick the Make field private check box to disallow direct access to the field.
  8. To apply the refactoring, click Next.
  9. If no conflicts are found, ReSharper performs the refactoring immediately. Otherwise, it prompts you to resolve conflicts.
ReSharper. Encapsulate Filed refactoring

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

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.

See Also

Last modified: 19 August 2016