Estilo de código

La limpieza de código es una funcionalidad que le ayuda a eliminar instantáneamente las violaciones al estilo de código en uno o más archivos, un proyecto o en la solución completa, todo con un único acceso directo: Ctrl+E, C.

Existen dos perfiles predeterminados: Full Cleanup (que se aplica a todos los ajustes de estilo de código excepto al estilo de nomenclatura) y Reformat Code (que solo se aplica a sus reglas de formateo), y ambos se pueden complementar con sus propios perfiles personalizados específicos para tareas.

ReSharper puede reformatear un bloque de código arbitrario seleccionado, todo el código del archivo actual, todos los archivos de un directorio o incluso la totalidad del proyecto o solución, de acuerdo con sus preferencias. ReSharper ofrece diferentes opciones de formateo para todos los lenguajes compatibles. El reformateo afecta la disposición de las llaves, las líneas en blanco, el ajuste de líneas y los saltos de línea, los espacios en distintos contextos, la sangría, la alineación de múltiples construcciones y muchas otras opciones que puede ajustar al detalle en el cuadro de diálogo ReSharper Options.

Para acceder a la configuración contextual de las reglas de formateo, presione Alt+Intro sobre el código seleccionado que desea formatear. Elija Format Selection | Configure en la lista de acciones para ver todas las reglas de formateo que afectan al código.

También puede usar la limpieza de código para reformatear el código.

El uso de variables locales escritas implícitamente (palabra clave var) a partir de C# 3.0 se ha popularizado gracias a la mayor legibilidad del código resultante. De forma predeterminada, ReSharper también favorece el uso de la palabra clave var.

Sin embargo, puede cambiar sus preferencias y optar por el uso de tipos explícitos.

También puede usar la limpieza de código para implementar sus preferencias de escritura implícita/explícita.

Las propiedades autoimplementadas (también conocidas como autopropiedades) permiten declarar de forma más simple propiedades de tipo que no tienen lógica adicional. De forma predeterminada, ReSharper favorece el uso de propiedades autoimplementadas siempre que sea posible, pero este comportamiento es configurable.

Puede convertir propiedades con campos de respaldo en propiedades autoimplementadas con un arreglo rápido o con la limpieza de código.

Los modificadores de tipos y miembros de tipos C# se pueden escribir en cualquier orden. Sin embargo, ordenarlos de forma similar a través de todo su código es una buena práctica que mejora la legibilidad del código. ReSharper le ayuda a definir el orden deseado, buscar modificadores no ordenados y ordenarlos automáticamente.

Además, ReSharper le ayuda a implementar sus preferencias de usar o no usar explícitamente los modificadores private e internal.

A menudo es razonable usar el modificador readonly para campos asignados en la declaración o en un constructor y que solo tienen usos de lectura. De forma predeterminada, ReSharper le sugiere pasar un campo a solo lectura si se cumplen las condiciones recién descritas.

Todas las preferencias para modificadores son configurables y puede aplicarlas con arreglos rápidos y limpieza de código.

ReSharper ofrece docenas de inspecciones de código para código redundante.

La mayoría de estas redundancias pueden limpiarse sin la interacción del usuario, ya sea con un arreglo dentro del ámbito o con la limpieza de código.

Al mover redundancias de código, ReSharper tiene en cuenta todas las demás configuraciones de estilo de código. Si se definen ciertas construcciones de código como no redundantes según los ajustes de estilo de código, se dejarán intactas.

ReSharper le permite definir ajustes de nomenclatura personalizados para distintos lenguajes y símbolos, incluidos tipos, espacios de nombres, interfaces, parámetros, propiedades y eventos de métodos, campos estáticos y de instancias, etc.

Para cada tipo de símbolo, podrá configurar una de cinco opciones de uso de mayúsculas/minúsculas, prefijos y sufijos, variaciones para diferentes permisos de acceso, abreviaciones a preservar y otras opciones.

Todas las violaciones del estilo de nomenclatura se resaltan en el editor y se puede corregir fácilmente.

Además de esto, puede explorar (y corregir rápidamente) todas las violaciones del estilo de nomenclatura en su solución completa (o en un ámbito más reducido) en la ventana de Inspection Results usando la funcionalidad Find Code Issues.

Para que su código sea más legible, puede eliminar las directivas "using" redundantes y/o acortar las referencias calificadas de sus archivos de código C# y VB.NET. Además, hay distintos enfoques para importar espacios de nombres: puede bien añadir directivas using/import o bien usar nombres de tipo totalmente calificados, puede colocar las directivas sobre el archivo o dentro del espacio de nombres, etc.

Con ReSharper, puede detectar y eliminar rápidamente las importaciones redundantes directamente en el editor o puede usar la limpieza de código, que le puede ayudar además a ordenar alfabéticamente las directivas requeridas y ajustarlas a una región.

Las palabras claves de tipos C# y los nombres de tipo .NET Framework (CLR) son intercambiables por tipos C# integrados. Si prefiere comprometerse con uno u otro estilo para los nombres de tipo integrados, ReSharper puede ayudarle a mantener su preferencia.

La preferencia es configurable y también puede implementarla con la limpieza de código.

Los atributos múltiples en C# se pueden escribir de distintas formas: puede unir varios atributos dentro de la misma sección definida por corchetes o usar varias secciones de distintos atributos. ReSharper permite especificar un estilo para atributos múltiples e implementar este estilo en el ámbito deseado:

ReSharper también proporciona múltiples reglas de formateo para atributos y permite aplicar todas las preferencias de estilo para atributos en un modo por lotes con la limpieza de código.

En C# puede calificar miembros de instancias con la palabra clave this, y los miembros estáticos se pueden calificar con un nombre de tipo o un nombre de tipo base. Estos calificadores le ayudan a eliminar las ambigüedades de los miembros ocultos por variables locales o parámetros de métodos. En todos los demás casos, estos modificadores son opcionales, y puede decidir si usarlos o no. De forma predeterminada, ReSharper trata a todos los calificadores de miembros opcionales como redundantes y sugiere su eliminación.

Si prefiere usar calificadores opcionales, puede configurar los ajuste correspondientes de estilo de código. Por ejemplo, podría preferir calificar los métodos estáticos con el tipo donde se declaran.