重命名代码符号重构

This refactoring applies to:

  • C#(编程语言)

  • Visual Basic

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

什么时候: 想要安全地重命名某些内容,而无需查找所有实例,并复制/粘贴新名称。

为什么: 复制并粘贴整个项目中的新名称可能会导致错误。 此重构工具准确执行重命名作。

操作说明

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

    • C#:

      Highlighted code - C#

    • Visual Basic:

      Highlighted code - Visual Basic

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

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

    • C#:

      重命名动画 - C#

    • Visual Basic:

      重命名 - VB

    小窍门

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

    小窍门

    还可以使用编辑器右上角显示的“重命名”框中的复选框更新注释和其他字符串以使用此新名称,并预览所做的更改

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

注解

  • 从 Visual Studio 2019 版本 16.3 开始,重命名与它所在的文件名匹配的类型时,将显示一个复选框,使你能够同时重命名文件。 重命名类、接口或枚举时,将显示此选项。 对于具有多个定义的分部类型,不支持此选项。

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

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

    重命名冲突

  • 重命名符号的另一种方法是在编辑器中更改其名称。 然后,使用符号名称中的光标,按 Ctrl+或者只需展开显示的灯泡图标菜单,然后选择“将旧名称重命名<为<新名称>>”。

    在编辑器中重命名

另请参阅