Cambiar el nombre y mover refactorizaciones

Visual Studio proporciona varias refactorizaciones para cambiar el nombre y reorganizar los símbolos y archivos de código. Puede acceder a estas refactorizaciones a través del menú Acciones rápidas y refactorizaciones (Ctrl+.).

Cambiar el nombre de un símbolo de código

Applies to: C#, Visual Basic

Esta refactorización cambia de nombre de forma segura los identificadores de símbolos de código, como campos, variables locales, métodos, espacios de nombres, propiedades y tipos. Todas las referencias del proyecto se actualizan automáticamente, evitando errores de búsqueda y reemplazo manuales.

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

   • C#:

     

   • Visual Basic:

     

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

   • Keyboard
     • Presione Ctrl+R y, a continuación, Ctrl+R. (El método abreviado de teclado puede ser diferente en función del perfil seleccionado).
   • Ratón
     • Seleccione Editar > cambio de nombre de refactorización>.
     • Haga clic con el botón derecho en el código y seleccione Cambiar nombre.

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

   • C#:

     

   • Visual Basic:

     

   Sugerencia

   También puede actualizar comentarios y otras cadenas para usar este nuevo nombre, así como obtener una vista previa de los cambios antes de guardarlos, usando las casillas del cuadro Cambiar nombre que aparecen al abrir el menú desplegable.

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

Observaciones

• A partir de Visual Studio versión 16.3 de 2019, al cambiar el nombre de un tipo que coincida con el nombre del archivo en el que se encuentra, aparece una casilla que le permite cambiar el nombre del archivo al mismo tiempo. Esta opción aparece al cambiar el nombre de una clase, interfaz o enumeración. Esta opción no se admite para tipos parciales con varias definiciones.

  

• Si usa un nombre que ya existe, lo que provocaría un conflicto, el cuadro Cambiar nombre le advierte.

  

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

  

Trasladar tipo a archivo coincidente

Applies to: C#, Visual Basic

Esta refactorización mueve un tipo a un archivo independiente con el mismo nombre, lo que mejora la organización del código y la navegación cuando tiene varios tipos en un archivo.

1. Coloque el cursor dentro del nombre del tipo donde se define. Por ejemplo:

   • C#
   • VB

   class Person
   

2. A continuación, realice una de las acciones siguientes:

   • Presione Ctrl+.
   • Haga clic con el botón derecho en el nombre de tipo y seleccione Acciones rápidas y refactorizaciones.

3. Seleccione Mover tipo a TypeName.cs en el menú, donde TypeName es el nombre del tipo seleccionado.

   El tipo se mueve a un nuevo archivo del proyecto que tiene el mismo nombre que el tipo.

   • C#:

     

   • Visual Basic:

     

Tipo de sincronización y nombre de archivo

Applies to: C#, Visual Basic

Esta refactorización cambia el nombre de un tipo para que coincida con el nombre de archivo o cambia el nombre de un nombre de archivo para que coincida con el tipo que contiene, manteniendo el código organizado y fácil de navegar.

1. Resalte o coloque el cursor de texto dentro del nombre del tipo que se va a sincronizar:

   • C#:

     

   • Visual Basic:

     

2. A continuación, realice una de las acciones siguientes:

   • Keyboard
     • Presione Ctrl+. para desencadenar el menú Acciones rápidas y refactorizaciones y seleccione Cambiar nombre de archivo a TypeName.cs en el menú emergente de la ventana Vista previa, donde TypeName es el nombre del tipo que ha seleccionado.
     • Presione Ctrl+. para desencadenar el menú Acciones rápidas y refactorizaciones y seleccione Cambiar nombre de tipo a Nombre de archivo en el menú emergente de la ventana Vista previa, donde Filename es el nombre del archivo actual.
   • Ratón
     • Haga clic con el botón derecho en el código, seleccione el menú Acciones rápidas y Refactorizaciones y seleccione Cambiar nombre de archivo a TypeName.cs en el menú emergente de la ventana Vista previa, donde TypeName es el nombre del tipo que ha seleccionado.
     • Haga clic con el botón derecho en el código, seleccione el menú Acciones rápidas y Refactorizaciones y seleccione Cambiar nombre de tipo a Nombre de archivo en el menú emergente de la ventana Vista previa, donde Filename es el nombre del archivo actual.

   Se cambia el nombre del tipo o archivo.

   • C#: En el ejemplo siguiente, se cambió el nombre del archivo MyClass.cs a MyNewClass.cs para que coincida con el nombre de tipo.

     

   • Visual Basic: en el ejemplo siguiente, se cambió el nombre del archivo Employee.vb a Person.vb para que coincida con el nombre de tipo.

     

Sincronización de espacio de nombres y nombre de carpeta

Se aplica a: C#

Esta refactorización actualiza el espacio de nombres para que coincida con la estructura de carpetas al mover un archivo a una nueva carpeta.

1. Coloque el cursor en el nombre del espacio de nombres.

2. Presione Ctrl+. para activar el menú Acciones rápidas y refactorizaciones.

3. Seleccione Cambiar espacio de nombres a <nombre> de carpeta.

   

Mover la declaración cerca de la referencia

Applies to: C#, Visual Basic

Esta refactorización mueve las declaraciones de variables más cerca de su uso, lo que mejora la legibilidad y limita el ámbito de las variables.

1. Coloque el cursor en la declaración de variable.

2. A continuación, realice una de las acciones siguientes:

   • Keyboard
     • Presione Ctrl+. para desencadenar el menú Acciones rápidas y refactorizaciones y seleccione Mover declaración cerca de referencia en el menú emergente de la ventana Vista previa.
   • Ratón
     • Haga clic con el botón derecho en el código, seleccione el menú Acciones rápidas y refactorizaciones y seleccione Mover declaración cerca de referencia en el menú emergente de la ventana Vista previa.

3. Cuando esté satisfecho con el cambio, presione Entrar o haga clic en la corrección en el menú y se confirmarán los cambios.

Ejemplo:

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

// Move declaration near reference

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

Contenido relacionado

• Refactorización
• Vista previa de cambios