Extract Class refactoring
This refactoring allows you to move members of an existing class to a new class. It will be helpful when you need to replace a single class that is responsible for multiple tasks with several classes each having a single responsibility.
JetBrains Rider will automatically create a reference field that will provide access to the newly created class. If necessary, you can also leave the extracted members in the original class as copies or so that the implementation is delegated to the same members in the new class.
tip
The reverse functionality is available with the Inline Class refactoring refactoring.
In the example below, we extract the LogError
method into the new Logger
class
Before
class Shape{ public void Draw() { try { /*draw*/ } catch (Exception e) { LogError(e); } } public static void LogError(Exception e) { File.WriteAllText(@"c:\Errors\Exception.txt", e.ToString()); }}
After
class Shape{ public void Draw() { try { /*draw*/ } catch (Exception e) { Logger.LogError(e); } }}class Logger{ public static void LogError(Exception e) { File.WriteAllText(@"c:\Errors\Exception.txt", e.ToString()); }}
Select a class or a member that you want to move in one of the following ways:
In the editor, place the caret at the name of a class or a member.
Select a class or a member in the Structure window.
Do one of the following:
Press and then choose Extract Class.
Choose Refactor | Extract Class from the main menu.
The Extract Class dialog will open.
Specify a name for the new class and where it should be placed — in a new file or in the same file as the original type.
Select members to be moved to the new class. When you select a member, JetBrains Rider suggests extracting other members that have usages of the selected member. You can recognize the suggested members by the green Extract label.
You do not have to accept this suggestion, but if you will, you can click Extract all suggested members to select all of them.
All selected members have a selector in the Source class member column. If you want the member to be directly available in the current class, click this selector and choose Create delegating wrapper for methods and properties or Create copy for properties and fields.
If you are extracting a non-public member, which is used by other members that you do not extract, JetBrains Rider warns you that these usages will not work if the extracted member is left non-public. You can either select the dependent members by clicking Extract all suggested members or click the warning icon and choose one of the suggested fixes:
To apply the refactoring, click Next.
If no conflicts are found, JetBrains Rider performs the refactoring immediately. Otherwise, it prompts you to resolve conflicts.
tip
Right after the refactoring has been completed, all changes that it makes anywhere, including other files, are registered as a single operation. So you can use the Undo action to roll back all these changes with a single keystroke.