Se recomienda usar Visual Studio 2017

Refactorización (C#)

 

System_CAPS_ICON_note.jpg Nota

Para obtener la documentación más reciente sobre C#, visite C# Guide (Guía de C#) en docs.microsoft.com.

La refactorización es el proceso que consiste en mejorar el código una vez escrito cambiando su estructura interna sin modificar su comportamiento externo.

Visual C# proporciona los siguientes comandos de refactorización en el menú Refactorización:

Visual Studio admite la refactorización de varios proyectos que se encuentran en la misma solución. Todas las operaciones de refactorización que corrigen referencias entre archivos corrigen dichas referencias entre todos los proyectos del mismo lenguaje. Esto sólo funciona en referencias entre proyectos. Por ejemplo, si tiene una aplicación de consola que haga referencia a una biblioteca de clases, al cambiar el nombre a un tipo de biblioteca de clases (mediante la operación de refactorización Rename), también se actualizarán las referencias al tipo de biblioteca de clases en la aplicación de consola.

Muchas operaciones de refactorización proporcionan la posibilidad de revisar todos los cambios de referencias que realiza una operación de refactorización en el código, antes de aplicar dichos cambios. Para estas operaciones de refactorización, aparecerá una opción Vista previa de los cambios de referencia en el cuadro de diálogo de refactorización. Después de seleccionar dicha opción y aceptar la operación de refactorización, aparecerá el cuadro de diálogo Obtener vista previa de cambios. Observe que el cuadro de diálogo Obtener vista previa de cambios tiene dos vistas. La vista inferior mostrará el código con todas las actualizaciones de referencias debido a la operación de refactorización. Si presiona Cancelar en el cuadro de diálogo Obtener vista previa de cambios, se detendrá la operación de refactorización y el código no sufrirá ningún cambio.

Si el compilador no tiene un conocimiento completo del programa y es posible que el motor de refactorización no pueda actualizar todas las referencias apropiadas, se muestra el cuadro de diálogo de advertencia. Este cuadro de diálogo de advertencia también ofrece la posibilidad de realizar una vista previa del código en el cuadro de diálogo Obtener vista previa de cambios antes de confirmar los cambios.

System_CAPS_ICON_note.jpg Nota

Si un método contiene un error de sintaxis (que el IDE indica con una línea de subrayado ondulada roja), el motor de refactorización no actualizará las referencias a un elemento dentro de dicho método. El ejemplo siguiente muestra este comportamiento.

De forma predeterminada, si ejecuta una operación de refactorización sin realizar una vista previa de los cambios de las referencias y el programa detecta un error de compilación, el entorno de desarrollo mostrará este cuadro de diálogo de advertencia.

Si ejecuta una operación de refactorización que tiene habilitada la opción Vista previa de los cambios de referencia y el programa detecta un error de compilación, el entorno de desarrollo mostrará el siguiente mensaje de advertencia en la parte inferior del cuadro de diálogo Obtener vista previa de cambios, en lugar de mostrar el cuadro de diálogo Advertencia de refactorización:

El proyecto o una de sus dependencias no se compila actualmente. Puede que las referencias no estén actualizadas.

Esta advertencia de refactorización solo está disponible para las operaciones de refactorización que proporcionan la opción Vista previa de los cambios de referencia.

La refactorización tolera errores. En otros términos, se puede realizar una refactorización en un proyecto que no se puede compilar. Sin embargo, en estos casos el proceso de refactorización podría no actualizar correctamente las referencias ambiguas.

El cuadro de diálogo Resultados de la comprobación puede notificar si el motor de refactorización detecta errores de la compilación o si detecta que una operación de refactorización hace que, inadvertidamente, una referencia del código se enlace a algo diferente de a lo que estaba enlazada.

Para activar la característica de resultados de comprobación, en el menú Herramientas, haga clic en Opciones. En el cuadro de diálogo Opciones, expanda Editor de texto y, a continuación, haga clic en C#. Haga clic en Avanzada y active la casilla Comprobar resultados de refactorización.

El cuadro de diálogo Resultados de la comprobación distingue entre dos tipos de problemas de reenlace.

Referencias cuya definición ya no será el símbolo al que se ha cambiado el nombre

Este tipo de problema de reenlace se produce cuando una referencia ya no hace referencia a un símbolo cuyo nombre ha cambiado. Por ejemplo, considere el siguiente código:

class Example  
{  
    private int a;  
    public Example(int b)  
    {  
        a = b;  
    }  
}  

Si utiliza la refactorización para cambiar el nombre de a por b, aparece este cuadro de diálogo. La referencia a la variable a, cuyo nombre ha cambiado, ahora se enlaza al parámetro que se pasa al constructor, en lugar de enlazarse al campo.

Referencias cuya definición pasará a ser el símbolo cuyo nombre ha cambiado

Este tipo de problema de reenlace se produce cuando una referencia que antes no hacía referencia al símbolo cuyo nombre ha cambiado, ahora sí hace referencia a él. Por ejemplo, considere el siguiente código:

class Example  
{  
    private static void Method(object a) { }  
    private static void OtherMethod(int a) { }  
    static void Main(string[] args)  
    {  
        Method(5);  
    }  
}  

Si utiliza la refactorización para cambiar el nombre de OtherMethod por Method, aparece este cuadro de diálogo. La referencia de Main ahora hace referencia al método sobrecargado que acepta un parámetro int en lugar del método sobrecargado que acepta un parámetro object.

Utilizar el entorno de desarrollo de Visual C#
Cómo: Restaurar miniprogramas de refactorización de C#

Mostrar: