“重命名代码符号”重构

此重构适用于:

  • C#

  • Visual Basic

内容: 允许重命名代码符号的标识符,例如字段、局部变量、方法、命名空间、属性和类型。

使用时机: 想要安全地进行重命名(无需查找所有实例)并复制/粘贴新名称。

操作原因:复制和粘贴整个项目的新名称可能会导致错误。 此重构工具准确执行重命名操作。

操作说明

  1. 突出显示要重命名的项,或将文本光标置于其中:

    • C#:

      突出显示的代码 - C#

    • Visual Basic:

      突出显示的代码 - Visual Basic

  2. 接下来,按如下所示使用键盘或鼠标:

    • 键盘
      • 按“Ctrl+R”,然后按“Ctrl+R”。 (键盘快捷方式可能因所选配置文件而异。
    • 鼠标
      • 选择“编辑”>“重构”>“重命名”。
      • 右键单击代码并选择“重命名”。
  3. 只需通过键入新名称即可重命名项。

    • C#:

      重命名动画 - C#

    • Visual Basic:

      重命名 - VB

    提示

    还可以更新注释和其他字符串以使用此新名称,以及在保存之前预览更改,使用打开下拉菜单时显示的“重命名”框中的复选框

    提示

    还可将注释和其他字符串更新为使用该新名称,也可在保存前使用“重命名”框(在编辑器的右上方)中的复选框预览更改

  4. 如果对更改感到满意,请选择 “应用 ”按钮或按 Enter 并提交更改。

注解

  • 从 Visual Studio 2019 16.3 版开始,在重命名与它所在的文件的名称相匹配的类型时,将出现一个复选框,你可以在其中同时重命名该文件。 重命名类、接口或枚举时,也会显示此选项。 对于具有多个定义的分部类型,不支持此选项。

    使用文件重命名动画 - C#

  • 如果使用已存在导致冲突的名称,则重命名框会发出警告。

    重命名冲突

  • 重命名符号的另一种方法是在编辑器中更改其名称。 然后,将光标置于符号名称中,按 Ctrl+.,或者直接展开出现的灯泡图标菜单,然后选择“将 <旧名称> 重命名为 <新名称>”。

    在编辑器中重命名

另请参阅