Cuadro de diálogo Opciones: Editor de texto> C# > Estilo de código > Formato
Use la página de opciones Formato y sus subpáginas (Sangría, Nuevas líneas, Espaciado y Ajuste) para establecer las opciones de formato del código del editor de código.
Para acceder a esta página de opciones, seleccione Herramientas > Opciones en la barra de menús. En el cuadro de diálogo Opciones, elija Editor de texto > C# > Estilo de código > Formato.
Sugerencia
Las subpáginas Sangría, Nuevas líneas, Espaciado y Ajuste muestran cada una una ventana de vista previa en la parte inferior que muestra el efecto de cada opción. Para usar la ventana de vista previa, seleccione una opción de formato. La ventana de vista previa muestra un ejemplo de la opción seleccionada. Cuando cambia la configuración (activando o desactivando una casilla o un botón de radio), la ventana de vista previa se actualiza para mostrar el efecto de la nueva configuración.
Formato (Página) (General)
Configuración general
Esta configuración afecta al momento en que el editor de código aplica las opciones de formato al código.
| Etiqueta | Descripción |
|---|---|
| Dar formato automáticamente al escribir | Si está desactivada, las opciones Dar formato automáticamente a la instrucción al introducir ; y Dar formato automáticamente al bloque al introducir } están desactivadas. |
| Dar formato automáticamente a la instrucción al introducir ; | Si está activada, da formato a las instrucciones a su finalización según las opciones de formato seleccionadas para el editor. |
| Dar formato automáticamente al bloque al introducir } | Si está activada, da formato a los bloques de código según las opciones de formato seleccionadas para el editor de código tan pronto como complete el bloque de código. |
| Dar formato automáticamente al volver | Si está activada, da formato al texto cuando se presiona Entrar para ajustarlo a las opciones de formato seleccionadas para el editor. |
| Dar formato automáticamente al pegar | Si está activada, da formato al texto pegado en el editor para ajustarlo a las opciones de formato seleccionadas para el editor. |
Si anteriormente aplicó configuración de estilo de código para archivos de C# mediante el comando Dar formato al documento de Visual Studio 2017, esa funcionalidad ahora está disponible como Limpieza de código.
Configuración para dar formato al documento
Estos valores configuran el comando Dar formato al documento para realizar la limpieza de código adicional en un archivo. Para más información sobre cómo se aplican estas opciones, vea Dar formato al documento.
| Etiqueta | Descripción | EditorConfig correspondiente y Herramientas > Reglas de opciones |
|---|---|---|
| Aplicar todas las reglas de formato de C# (sangría, ajuste, espaciado) | El comando Dar formato al documento siempre corrige problemas de formato. No se puede cambiar esta opción. | Opciones de EditorConfig Core Opciones de formato de .NET EditorConfig Herramientas > Opciones > Editor de texto > C# > Formato > [Sangría o Nuevas líneas o Espaciado o Ajuste de texto] |
| Realizar limpieza de código adicional durante la aplicación de formato | Cuando se selecciona, se aplican revisiones para las reglas especificadas a continuación en el comando Edit.FormatDocument. | N/D |
| Quitar directivas Using innecesarias | Cuando se selecciona, se quitan las directivas using innecesarias cuando se desencadena Edit.FormatDocument. |
N/D |
| Ordenar instrucciones Using | Cuando se selecciona, se ordenan las directivas using cuando se desencadena Edit.FormatDocument. |
dotnet_sort_system_directives_first Herramientas > Opciones > Editor de texto > C# > Avanzado > Aplicar primero directivas "System" al ordenar instrucciones Using |
| Agregar o quitar llaves en instrucciones de control de una sola línea | Cuando se selecciona, se agregan o se quitan las llaves de instrucciones de control de línea única cuando se desencadena Edit.FormatDocument. | csharp_prefer_braces Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias del bloque de código > Preferir llaves |
| Agregar modificadores de accesibilidad | Cuando se selecciona, se agregan los modificadores de accesibilidad que faltan cuando se desencadena Edit.FormatDocument. | dotnet_style_require_accessibility_modifiers |
| Ordenar modificadores de accesibilidad | Cuando se selecciona, se ordenan los modificadores de accesibilidad cuando se desencadena Edit.FormatDocument. | csharp_preferred_modifier_order visual_basic_preferred_modifier_order |
| Aplicar preferencias de cuerpo de expresiones o bloques | Cuando se selecciona, se convierten los miembros con forma de expresión para bloquear cuerpos, o viceversa, cuando se desencadena Edit.FormatDocument. | Opciones de miembros con forma de expresión de EditorConfig Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de expresión > Usar cuerpo de expresiones para los métodos, constructores, etcétera. |
| Aplicar preferencias de tipos implícitos o explícitos | Cuando se selecciona, se convierte var al tipo explícito, o viceversa, cuando se desencadena Edit.FormatDocument. |
Opciones de EditorConfig de tipo explícito Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de 'var' |
| Aplicar preferencias de variables "out" insertadas | Cuando se selecciona, se usan variables out insertadas siempre que sea posible cuando se desencadena Edit.FormatDocument. |
csharp_style_inlined_variable_declaration Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de variable > Preferir declaración de variable insertada |
| Aplicar preferencias de tipo de marco o lenguaje | Cuando se selecciona, convierte los tipos de lenguaje en tipos de marco, o viceversa, cuando se desencadena Edit.FormatDocument. | dotnet_style_predefined_type_for_locals_parameters_members dotnet_style_predefined_type_for_member_access Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de tipo predefinido |
| Aplicar preferencias de inicialización de objeto o colección | Cuando se selecciona, se usan inicializadores de objeto y colección siempre que sea posible cuando se desencadena Edit.FormatDocument. | dotnet_style_object_initializer dotnet_style_collection_initializer Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de expresión > Preferir inicializador de objeto o Preferir inicializador de colección |
| Aplicar preferencias de calificación "this." | Cuando se selecciona, se aplican las preferencias de this. cuando se desencadena Edit.FormatDocument. |
Opciones de EditorConfig de calificación de this. Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de this. |
| Cuando sea posible, hacer que los campos privados sean de solo lectura | Cuando se selecciona, convierte los campos privados readonly siempre que sea posible cuando se desencadena Edit.FormatDocument. |
dotnet_style_readonly_field Herramientas > Opciones > Editor de texto > C# > Estilo de código > Preferencias de campo > Preferir readonly |
| Quitar conversiones innecesarias | Cuando se selecciona, se quitan las conversiones innecesarias siempre que sea posible cuando se desencadena Edit.FormatDocument. | N/D |
| Quitar variables no usadas | Cuando se selecciona, se quitan las variables no usadas cuando se desencadena Edit.FormatDocument. | N/D |
Sangría (Página)
Las opciones de sangría de esta página se aplican cuando se da formato automáticamente al código. Un ejemplo de aplicación automática de formato al código es cuando se pega código en el archivo mientras Dar formato automáticamente al pegar está seleccionado. (La opción Dar formato automáticamente al pegar se encuentra en Formato > General).
Sugerencia
También hay opciones de sangría en la página de opciones Editor de texto > C# > Pestañas. Esas opciones solo determinan dónde coloca el cursor el editor de código cuando se presiona Entrar al final de una línea.
