Refactorización de cambio de nombre de un símbolo de código

Esta refactorización se aplica a lo siguiente:

• C#

• Visual Basic

Qué: Permite cambiar el nombre de los identificadores de símbolos de código, como campos, variables locales, métodos, espacios de nombres, propiedades y tipos.

Cuándo: Se quiere cambiar con seguridad el nombre de algo sin tener que buscar todas las instancias y copiar y pegar el nombre nuevo.

Por qué: Es probable que copiar y pegar el nuevo nombre en todo un proyecto genere errores. Esta herramienta de refactorización llevará a cabo con precisión la acción de cambio de nombre.

Procedimiento

1. Resalte o coloque el cursor de texto dentro del elemento cuyo nombre se va a cambiar:

   • C#:

     

   • Visual Basic:

     

2. A continuación, use el teclado o el mouse de la manera siguiente:

   • Teclado
     • Presione CTRL+R y, a continuación, CTRL+R. (Tenga en cuenta que su método abreviado de teclado puede ser diferente en función del perfil que haya seleccionado).
   • Mouse
     • Seleccione Editar > Refactorizar > Cambiar nombre.
     • Haga clic con el botón derecho en el código y seleccione Cambiar nombre.

3. Cambie el nombre del elemento escribiendo el nuevo nombre.

   • C#:

     

   • Visual Basic:

     

   Sugerencia

   También puede actualizar los comentarios y otras cadenas para que usen este nuevo nombre, así como obtener una vista previa de los cambios antes de guardarlos; para ello, use las casillas del cuadro Cambiar nombre que aparece en la parte superior derecha del editor.

4. Cuando esté satisfecho con el cambio, seleccione el botón Aplicar o presione Entrar. Los cambios se confirmarán.

Comentarios

• A partir de la versión 16.3 de Visual Studio 2019, cuando se cambia el nombre de un tipo que coincide con el nombre del archivo en el que se encuentra, aparece una casilla que permite cambiar el nombre del archivo al mismo tiempo. Esta opción aparece cuando se cambia el nombre de una clase, una interfaz o una enumeración. No es compatible con los tipos parciales con varias definiciones.

  

• Si usa un nombre que ya existe, lo cual produciría un conflicto, el cuadro Cambiar nombre se lo advertirá.

  

• Otra manera de cambiar el nombre de un símbolo es cambiar su nombre en el editor. Luego, con el cursor en el nombre del símbolo, presione Ctrl+., o simplemente expanda el menú del icono de la bombilla que aparece y elija Cambiar nombre <nombre antiguo> a <nombre nuevo>.

  

Consulte también

• Refactorización
• Vista previa de cambios