Preferências de estilo de códigoCode style preferences

As preferências de estilo de código podem ser definidas em seus projetos em C# e do Visual Basic, abrindo a caixa de diálogo Opções no menu Ferramentas.Code style preferences can be set for your C# and Visual Basic projects by opening the Options dialog box from the Tools menu. Na caixa de diálogo Opções, selecione Editor de Texto > [C# ou Básico] > Estilo de Código > Geral.In the Options dialog box, select Text Editor > [C# or Basic] > Code Style > General. As opções definidas nessa janela aplicam-se apenas ao computador local.Options set in this window are applicable to the local machine only.

Cada item na lista mostra uma versão prévia da preferência quando selecionada:Each item in the list shows a preview of the preference when selected:

Opções de estilo de código

Preferência e gravidadePreference and severity

Para cada item, é possível definir os valores Preferência e Severidade usando as listas suspensas de cada linha.For each item, you can set the Preference and Severity values using the drop-downs on each line. A severidade pode ser definida como Nenhuma, Sugestão, Aviso ou Erro.Severity can be set to None, Suggestion, Warning, or Error. Se você quiser habilitar Ações Rápidas para um estilo de código, verifique se a configuração de Severidade está definida como algo diferente de Nenhuma.If you want to enable Quick Actions for a code style, ensure that the Severity setting is set to something other than None. O ícone de lâmpada Ações Rápidas Ícone de lâmpada pequeno é exibido quando um estilo não preferencial é usado. Você pode escolher uma opção na lista Ações Rápidas para reescrever o código automaticamente no estilo preferencial.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.

Arquivos EditorConfigEditorConfig files

As configurações de estilo de código para o .NET também podem ser gerenciadas com um arquivo EditorConfig.Code style settings for .NET can also be managed with an EditorConfig file. As configurações no arquivo EditorConfig têm precedência sobre as opções selecionadas na caixa de diálogo Opções.Settings in the EditorConfig file take precedence over options selected in the Options dialog box. É possível usar um arquivo EditorConfig para impor e configurar o estilo de codificação de todo o repositório ou projeto.You can use an EditorConfig file to enforce and configure the coding style for your entire repo or project.

Comando Formatar DocumentoFormat Document command

No Visual Studio 2017 versão 15.8 e posteriores, você pode configurar o comando Formatar Documento (Editar > Avançado > Formatar Documento) para executar uma limpeza de código adicional em um arquivo, como remover e classificar usings ou aplicar preferências 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. Você pode definir quais configurações deseja que Formatar Documento aplique na página Opções de formatação.You can define which settings you want Format Document to apply on the Formatting options page.

A limpeza de código respeita as configurações definidas em um arquivo .editorconfig ou a falta dessa regra ou arquivo, conforme a definição em Ferramentas > Opções > Editor de Texto > C# > [Estilos de Código ou Formatação].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].

Na primeira vez que você disparar o comando Formatar Documento no Visual Studio 2017, uma barra amarela de informações solicitará que você defina as configurações de limpeza 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

As regras configuradas como none em um arquivo .editorconfig não participam da limpeza de código, mas podem ser aplicadas individualmente por meio do menu Ações Rápidas e Refatorações.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.

Consulte tambémSee also