ReSharper 2018.2 Help

Encapsulate Field refactoring

ReSharper | Refactor | Encapsulate Field…
Ctrl+R,E
ReSharper_EncapsulateField

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

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

Before refactoring

After 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 in 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 and technologies:

Language: C#

Language: VB.NET

Language: C++

Language: HTML

Language: ASP.NET

Language: Razor

Language: JavaScript

Language: TypeScript

Language: CSS

Language: XML

Language: XAML

Language: Resx

Language: Build Scripts

Language: Protobuf

Language: JSON

Feature is available

Feature is available

Feature is not available

Feature is not available

Feature is not available

Feature is not available

Feature is not available

Feature is available

Feature is not available

Feature is not available

Feature is not available

Feature is not available

Feature is not available

Feature is not available

Feature is not 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.

Last modified: 21 December 2018

See Also