Preferencias de estilo del códigoCode style preferences

Para establecer las preferencias de estilo del código de los proyectos de C# y Visual Basic, abra el cuadro de diálogo Opciones desde el menú Herramientas.Code style preferences can be set for your C# and Visual Basic projects by opening the Options dialog box from the Tools menu. En el cuadro de diálogo Opciones, seleccione Editor de texto > [C# o Básica] > Estilo de código > General.In the Options dialog box, select Text Editor > [C# or Basic] > Code Style > General. Las opciones configuradas en esta ventana se aplican solamente a la máquina local.Options set in this window are applicable to the local machine only.

Cada elemento de la lista muestra una vista previa de la preferencia cuando se selecciona:Each item in the list shows a preview of the preference when selected:

Opciones de estilo de código

Preferencia y gravedadPreference and severity

Para cada elemento, puede establecer el valor de Preferencia y Gravedad usando las listas desplegables de cada línea.For each item, you can set the Preference and Severity values using the drop-downs on each line. La gravedad se puede establecer en Ninguno, Sugerencia, Advertencia o Error.Severity can be set to None, Suggestion, Warning, or Error. Si desea habilitar las Acciones rápidas para un estilo de código, asegúrese de que el valor Gravedad se establece en un valor distinto de Ninguno.If you want to enable Quick Actions for a code style, ensure that the Severity setting is set to something other than None. El icono de bombilla de Acciones rápidas icono de bombilla pequeña aparece cuando se usa un estilo no preferido y puede elegir una opción en la lista Acciones rápidas para volver a escribir código automáticamente para el estilo preferido.The Quick Actions light bulb icon Small light bulb icon appears when a non-preferred style is used, and you can choose an option on the Quick Actions list to automatically rewrite code to the preferred style.

Archivos EditorConfigEditorConfig files

También puede administrar la configuración del estilo de código para .NET con un archivo EditorConfig.Code style settings for .NET can also be managed with an EditorConfig file. La configuración del archivo EditorConfig tiene prioridad sobre las opciones seleccionadas en el cuadro de diálogo Opciones.Settings in the EditorConfig file take precedence over options selected in the Options dialog box. El archivo EditorConfig sirve para aplicar y configurar el estilo de codificación de todo el repositorio o proyecto.You can use an EditorConfig file to enforce and configure the coding style for your entire repo or project.

Comando Dar formato al documentoFormat Document command

En Visual Studio 2017 versión 15.8 y posteriores, puede configurar el comando Dar formato al documento (Edición > Avanzado > Dar formato al documento) para realizar la limpieza de código adicional en un archivo, como quitar y ordenar instrucciones using o aplicar las preferencias de estilo de código.In Visual Studio 2017 version 15.8 and later, you can configure the Format Document command (Edit > Advanced > Format Document) to perform additional code cleanup on a file, such as remove and sort usings or apply code-style preferences. Puede definir qué configuración quiere que Dar formato al documento aplique en la página de opciones Formato.You can define which settings you want Format Document to apply on the Formatting options page.

La limpieza de código respeta la configuración establecida en un archivo .editorconfig o, si falta dicha regla o archivo, la establecida en Herramientas > Opciones > Editor de texto > C# > [Estilo de código o Formato].Code cleanup respects settings configured in an .editorconfig file, or lacking that rule or file, those set in Tools > Options > Text Editor > C# > [Code Style or Formatting].

La primera vez que desencadena el comando Dar formato al documento en Visual Studio 2017, una barra amarilla de información le pedirá que configure las opciones de limpieza de código.The first time you trigger the Format Document command in Visual Studio 2017, a yellow info bar prompts you to configure your code cleanup settings.

Tip

Las reglas configuradas como ninguna en un archivo .editorconfig no participan en la limpieza de código, pero se pueden aplicar individualmente a través del menú Acciones rápidas y refactorizaciones.Rules configured as none in an .editorconfig file don't participate in code cleanup, but can be individually applied via the Quick Actions and Refactorings menu.

Vea tambiénSee also