Язык

Переименование и перемещение рефакторингов

Visual Studio предоставляет несколько рефакторингов для переименования и реорганизации символов кода и файлов. Эти рефакторинги можно получить через меню быстрых действий и рефакторингов (CTRL+.).

Переименование символа кода

Применимо к: C#, Visual Basic

Это рефакторинг безопасно переименовывает идентификаторы для символов кода, таких как поля, локальные переменные, методы, пространства имен, свойства и типы. Все ссылки по проекту обновляются автоматически, избегая ошибок из ручного поиска и замены.

  1. Выделите или поместите текстовый курсор в элемент, который необходимо переименовать:

    • C#:

      Снимок экрана: выделенный код для переименования — C#.

    • Visual Basic:

      Screenshot выделенного кода для переименования — Visual Basic.

  2. Затем используйте клавиатуру или мышь следующим образом:

    • Клавиатура
      • Нажмите клавиши CTRL+R, а затем CTRL+R. (Сочетание клавиш может отличаться в зависимости от выбранного профиля.)
    • Мышь
      • Выберите изменить > переименование рефакторинга>.
      • Щелкните код правой кнопкой мыши и выберите "Переименовать".
  3. Просто переименуйте элемент, введя новое имя.

    • C#:

      Снимок экрана: анимация переименования — C#.

    • Visual Basic:

      Снимок экрана: переименование — VB.

    Подсказка

    Вы также можете обновить примечания и другие строки, чтобы использовать это новое имя, а также просмотреть изменения перед сохранением, используя флажки в поле "Переименовать ", которое отображается при открытии раскрывающегося меню.

  4. Когда вы довольны изменением, нажмите кнопку "Применить " или нажмите клавишу ВВОД и фиксируются изменения.

Замечания

  • Начиная с Visual Studio 2019 версии 16.3 при переименовании типа, соответствующего имени файла, в который он находится, появится флажок, позволяющий одновременно переименовать файл. Этот параметр отображается при переименовании класса, интерфейса или перечисления. Этот параметр не поддерживается для частичных типов с несколькими определениями.

    Снимок экрана: переименование анимации с файлом — C#.

  • Если вы используете имя, которое уже существует, что приведет к конфликту, поле переименования предупреждает вас.

    Снимок экрана: конфликт переименования.

  • Другим способом переименования символа является изменение его имени в редакторе. Затем с курсором в имени символа нажмите клавиши CTRL+или просто разверните отображаемое меню значка лампочки и выберите "Переименовать <старое имя" в >новое имя<>.

    Снимок экрана: переименование в редакторе.

Перемещение типа в соответствующий файл

Применимо к: C#, Visual Basic

Это рефакторинг перемещает тип в отдельный файл с одинаковым именем, повышая организацию кода и навигацию при наличии нескольких типов в одном файле.

  1. Поместите курсор в имя типа, в котором он определен. Рассмотрим пример.

    class Person
    
  2. Затем выполните одно из следующих действий:

    • Нажмите клавиши CTRL+.
    • Щелкните правой кнопкой мыши имя типа и выберите быстрые действия и рефакторинг
  3. Выберите "Переместить тип в TypeName.cs в меню, где TypeName — это имя выбранного типа.

    Тип перемещается в новый файл в проекте с тем же именем, что и тип.

    • C#:

      Снимок экрана: встроенный результат — C#.

    • Visual Basic:

      Screenshot встроенного результата — Visual Basic.

Тип синхронизации и имя файла

Применимо к: C#, Visual Basic

Это рефакторинг переименовывает тип, соответствующий имени файла, или переименовывает имя файла, соответствующее типу, который он содержит, сохраняя упорядоченный и удобный для навигации код.

Замечание

Эта рефакторинг пока недоступна для проектов .NET Standard и .NET Core.

  1. Выделите или поместите текстовый курсор внутри имени типа для синхронизации:

    • C#:

      Снимок экрана: выделенный код для типа синхронизации — C#.

    • Visual Basic:

      Screenshot выделенного кода для типа синхронизации — Visual Basic.

  2. Затем выполните одно из следующих действий:

    • Клавиатура
      • Нажмите клавиши CTRL+. Чтобы активировать меню "Быстрые действия" и "Рефакторинг" и выберите "Переименовать файл в TypeName.cs в всплывающем окне предварительного просмотра, где TypeName — имя выбранного типа.
      • Нажмите клавиши CTRL+. Чтобы активировать меню "Быстрые действия" и "Рефакторинг" и выберите "Переименовать тип в имя файла" во всплывающем окне предварительного просмотра, где имя файла — имя текущего файла.
    • Мышь
      • Щелкните правой кнопкой мыши код, выберите меню "Быстрые действия" и "Рефакторинг" и выберите "Переименовать файл в TypeName.cs в всплывающем окне предварительного просмотра, где TypeName — имя выбранного типа.
      • Щелкните правой кнопкой мыши код, выберите меню "Быстрые действия" и "Рефакторинг" и выберите "Переименовать тип в имя файла " во всплывающем окне предварительного просмотра, где имя файла — имя текущего файла.

    Тип или файл переименован.

    • C#: В приведенном ниже примере файл MyClass.cs был переименован в MyNewClass.cs , чтобы соответствовать имени типа.

      Снимок экрана: встроенный результат C#.

    • Visual Basic. В приведенном ниже примере файл Employee.vb был переименован в Person.vb для соответствия имени типа.

      Screenshot встроенного результата Visual Basic.

Синхронизация пространства имен и имени папки

Применимо к: C#

Это рефакторинг обновляет пространство имен, соответствующее структуре папок при перемещении файла в новую папку.

  1. Поместите курсор в имя пространства имен.

  2. Нажмите CTRL+., чтобы открыть меню Быстрые действия и рефакторинг.

  3. Выберите "Изменить пространство имен" на <имя> папки.

    Снимок экрана: пространство имен синхронизации и имя папки.

Перемещение объявления рядом со ссылкой

Применимо к: C#, Visual Basic

Это рефакторинг перемещает объявления переменных ближе к их использованию, повышая удобочитаемость и сужая область переменной.

  1. Поместите курсор в объявление переменной.

  2. Затем выполните одно из следующих действий:

    • Клавиатура
      • Нажмите клавиши CTRL+. Чтобы активировать меню "Быстрые действия" и "Рефакторинг" и выберите "Переместить объявление рядом со ссылкой " во всплывающем окне предварительного просмотра.
    • Мышь
      • Щелкните правой кнопкой мыши код, выберите меню "Быстрые действия" и "Рефакторинг" и выберите пункт "Переместить объявление рядом со ссылкой " во всплывающем окне предварительного просмотра.
  3. Когда вы довольны изменением, нажмите клавишу ВВОД или щелкните исправление в меню и изменения фиксируются.

Пример:

// Before
int x;
if (condition)
{
    x = 1;
    Console.WriteLine(x);
}

// Move declaration near reference

// After
if (condition)
{
    int x = 1;
    Console.WriteLine(x);
}