Compartilhar via


Preferências de estilo de código

Você pode definir as configurações de estilo de código por projeto usando um arquivo EditorConfigou para todo o código editado no Visual Studio no editor de texto Opções página. Para código C#, você também pode configurar o Visual Studio para aplicar essas preferências de estilo de código usando os comandos de Limpeza de Código (Visual Studio 2019, Visual Studio 2022) e Formatar Documento (Visual Studio 2017).

Estilos de código em arquivos EditorConfig

Configurações de estilo de código para .NET podem ser especificadas adicionando um arquivo EditorConfig ao seu projeto. Os arquivos EditorConfig são associados a uma base de código em vez de uma conta de personalização do Visual Studio. As configurações em um arquivo EditorConfig têm precedência sobre os estilos de código especificados na caixa de diálogo opções . Use um arquivo EditorConfig quando quiser impor estilos de codificação para todos os colaboradores para seu repositório ou projeto.

Você pode preencher manualmente o arquivo EditorConfig ou gerar automaticamente o arquivo com base nas configurações de estilo de código escolhidas na caixa de diálogo Opções do Visual Studio. Esta página de opções está disponível no Tools>Options>Text Editor> [C# ou Basic] >Code Style>General. Clique em Gerar arquivo .editorconfig das configurações para gerar automaticamente um arquivo .editorconfig de estilo de codificação com base nas configurações na página Opções.

Captura de tela da geração do arquivo editorconfig a partir das configurações.

Você pode preencher manualmente o arquivo EditorConfig ou gerar automaticamente o arquivo com base nas configurações de estilo de código escolhidas na caixa de diálogo Opções do Visual Studio. Esta página de opções está disponível em Ferramentas >Opções>Editor de Texto> [C# ou Visual Basic] >Estilo de Código>Geral. Clique em Gerar arquivo .editorconfig das configurações para gerar automaticamente um arquivo .editorconfig de estilo de codificação com base nas configurações na página Opções.

Captura de tela de Gerar arquivo editorconfig a partir das configurações.

Estilos de código na caixa de diálogo Opções

As preferências de estilo de código podem ser definidas para todos os seus projetos de C# e Visual Basic abrindo a caixa de diálogo Opções no menu Ferramentas. Na caixa de diálogo Opções, selecione Editor de Texto> [C# ou Visual Basic] >Estilo de código>Geral.

As preferências de estilo de código podem ser definidas para todos os seus projetos do C# e do Visual Basic abrindo a caixa de diálogo Opções no menu Ferramentas. Na caixa de diálogo Opções do, selecione Editor de Texto> [C# ou básico] >Estilo de Código>Geral.

Cada item na lista mostra uma visualização da preferência quando selecionado:

Captura de tela das opções de estilo de código.

Captura de tela das opções de estilo de código.

As opções definidas nesta janela são aplicáveis à sua conta de personalização do Visual Studio e não estão associadas a um projeto ou base de código específica. Além disso, elas não são impostas durante o processo de build, incluindo as builds de integração contínua (CI). Se você quiser associar preferências de estilo de código ao seu projeto e ter os estilos impostos durante o build, especifique as preferências em um arquivo .editorconfig associado ao projeto.

Preferência e gravidade

Em cada configuração de estilo de código nessa página, é possível definir os valores de Preferência e Gravidade usando as listas suspensas de cada linha. A gravidade pode ser definida como Somente Refatoração, Sugestão, Aviso ou Erro. Se você quiser habilitar Ações Rápidas para um estilo de código, verifique se a configuração de Gravidade está definida como algo diferente de Somente Refatoração. O ícone de lâmpada Ações Rápidas, lâmpada de erro ou chave de fenda aparece quando um estilo não preferencial é usado. É possível escolher uma opção na lista Ações Rápidas para reescrever o código automaticamente no estilo preferencial.

Impor estilo de código na compilação

A partir do Visual Studio 2019 versão 16.8, que inclui o SDK do .NET 5.0 RC2, é possível impor as convenções de codificação do .NET na compilação para todos os projetos do .NET. No momento do build, as violações de estilo de código do .NET serão exibidas como avisos ou erros com um prefixo "IDE". Isso permite que você imponha estritamente estilos de código consistentes em sua base de código.

Aplicar estilos de código

Para arquivos de código C#, o Visual Studio tem um botão de Limpeza de Código na parte inferior do editor (teclado: Ctrl+K, Ctrl+E) para aplicar estilos de código de um arquivo EditorConfig ou da página de opções estilo de código do. Se houver um arquivo .editorconfig para o projeto, essas serão as configurações que têm precedência.

Dica

As regras configuradas com uma gravidade de Nenhum não participam da limpeza de código, mas podem ser aplicadas individualmente por meio do menu Ações rápidas e refatorações.

Para aplicar estilos de código:

  1. Primeiro, configure quais estilos de código você deseja aplicar (em um dos dois perfis) na caixa de diálogo Configurar Limpeza de Código. Para abrir essa caixa de diálogo, clique na seta de expansão ao lado do ícone de vassoura de limpeza de código e, em seguida, escolha Configurar limpeza de código.

    Captura de tela de Configurar limpeza de código.

  2. Depois de configurar a limpeza de código, use um dos seguintes métodos para executar a limpeza de código:

    • Clique no ícone de vassoura ou pressione Ctrl+K, Ctrl+E para executar a limpeza de código.

      Captura de tela de Executar limpeza de código.

    • Para executar a limpeza de código em todo o projeto ou solução, clique com o botão direito do mouse no nome do projeto ou da solução no do Gerenciador de Soluções, selecione Analisar e Limpar Códigoe selecione Executar Limpeza de Código.

      Captura de tela Executar Limpeza de Código em todo projeto ou em toda solução.

    Se quiser que as configurações de estilo de código sejam aplicadas sempre que salvar um arquivo, você poderá gostar da limpeza de código na extensão Salvar.

Para arquivos de código C#, o Visual Studio tem um botão de Limpeza de Código na parte inferior do editor (teclado: Ctrl+K, Ctrl+E) para aplicar estilos de código de um arquivo EditorConfig ou da página de opções estilo de código do. Se houver um arquivo .editorconfig para o projeto, essas serão as configurações que têm precedência.

Dica

As regras configuradas com uma gravidade de Nenhum não participam da limpeza de código, mas podem ser aplicadas individualmente por meio do menu Ações rápidas e refatorações.

Para aplicar estilos de código:

  1. Primeiro, configure quais estilos de código você deseja aplicar (em um dos dois perfis) na caixa de diálogo Configurar Limpeza de Código. Para abrir essa caixa de diálogo, clique na seta de expansão ao lado do ícone de vassoura de limpeza de código e, em seguida, escolha Configurar limpeza de código.

    Captura de tela de Configurar limpeza de código.

  2. Depois de configurar a limpeza de código, use um dos seguintes métodos para executar a limpeza de código:

    • Clique no ícone de vassoura ou pressione Ctrl+K, Ctrl+E.

      Captura de tela de Executar limpeza de código.

    • Para executar a limpeza de código em todo o projeto ou solução, clique com o botão direito do mouse no nome do projeto ou da solução no do Gerenciador de Soluções, selecione Analisar e Limpar Códigoe selecione Executar Limpeza de Código.

      Captura de tela de Executar limpeza de código em todo o projeto ou solução.

    Se você quiser que as configurações de estilo de código sejam aplicadas sempre que salvar um arquivo, vá para Opções>Editor de Texto>Limpeza de Código e selecione Executar perfil de limpeza de código ao salvar.

Configurações de limpeza de código

A maioria das configurações de limpeza de código corresponde a um ou mais estilos de código .NET suportados por .editorconfig. Para obter exemplos que mostram os efeitos das configurações, use os links na tabela a seguir.

Configuração ID da regra ou opção de estilo
Remover importações ou usos desnecessários IDE0005
Classificar importações ou usos dotnet_sort_system_directives_first
dotnet_separate_import_directive_groups
Aplicar preferências de cabeçalho de arquivo file_header_template
Remover variáveis não utilizados CS0219
Aplicar preferências de criação de objeto visual_basic_style_prefer_simplified_object_creation
Aplicar preferências de IsNot visual_basic_style_prefer_isnot_expression
Adicionar a qualificação “este” ou “Eu” IDE0003-IDE0009
Adicionar modificadores de acessibilidade dotnet_style_require_accessibility_modifiers
Modificadores de ordem IDE0036
Tornar campo “somente leitura” dotnet_style_readonly_field
Remover conversões desnecessárias IDE0004
Aplicar parâmetros de inicialização de objeto/coleção) dotnet_style_object_initializer
Aplicar preferências de uso de posicionamento de diretiva csharp_using_directive_placement
Aplicar preferências de parênteses IDE0047-IDE0048
Aplicar preferências de valor não utilizado IDE0058
Aplicar preferências de tipo de linguagem/estrutura IDE0049
Remover supressões não utilizadas dotnet_remove_unnecessary_suppression_exclusions
Aplicar preferências de expressão booliana simplificada dotnet_style_prefer_simplified_boolean_expressions
Aplicar preferências de interpolação de cadeia de caracteres dotnet_style_prefer_simplified_interpolation
Remover parâmetros não utilizados dotnet_code_quality_unused_parameters
Aplicar preferências de propriedade automática dotnet_style_prefer_auto_properties
Aplicar preferências de atribuição composta dotnet_style_prefer_compound_assignment
Aplicar preferências de expressão de união dotnet_style_coalesce_expression
Aplicar preferências de expressão condicional dotnet_style_prefer_conditional_expression_over_assignment
dotnet_style_prefer_conditional_expression_over_return
Aplicar preferências de nome de tupla dotnet_style_explicit_tuple_names
dotnet_style_prefer_inferred_tuple_names
Aplicar preferências de nomes de membros de tipo anônimo inferidos dotnet_style_prefer_inferred_anonymous_type_member_names
Aplicar preferências de verificação nula dotnet_style_prefer_is_null_check_over_reference_equality_method
Aplicar preferências de propagação nulas dotnet_style_null_propagation
Aplicar preferências de 'var' IDE0007-IDE0008
Adicionar as chaves necessárias para as instruções de controle de linha única csharp_prefer_braces
Aplicar preferências de corpo de expressão/bloco Membros de expressão incorporada
Aplicar preferências de variáveis 'out' embutidas csharp_style_inlined_variable_declaration
Aplicar preferências para correspondência de padrões Preferências de padrões correspondentes
Aplicar preferências de chamada de delegado condicional csharp_style_conditional_delegate_call
Aplicar preferências de função local estática csharp_prefer_static_local_function
Aplicar preferências de desconstrução csharp_style_deconstructed_variable_declaration
Aplicar preferências padrão(T) csharp_prefer_simple_default_expression
Aplicar preferências novas() csharp_style_implicit_object_creation_when_type_is_apparent
Aplicar preferências de intervalo csharp_style_prefer_range_operator
Priorizar funções locais sobre funções anônimas. csharp_style_pattern_local_over_anonymous_function
Aplicar preferências nulas de parâmetro Preferências de verificação de nulo
Aplicar preferências de uso de instrução csharp_prefer_simple_using_statement
Aplicar preferências de expressão throw csharp_style_throw_expression

::: moniker-end