Caixa de diálogo opções: > formatação de > estilo de código C# do editor de texto >

Use a página de opções de Formatação e suas subpáginas (Recuo, Novas Linhas, Espaçamento e Encapsulamento) para definir opções de formatação de código no editor de código.

Para acessar essa página de opções, escolha ferramentas > Opções na barra de menus. Na caixa de diálogo Opções, escolha Editor de Texto > C# > Estilo de Código > Formatação.

Dica

As subpáginas Recuo, Novas Linhas, Espaçamento e Quebra Automática exibem uma janela de visualização na parte inferior que mostra o efeito de cada opção. Para usar a janela de visualização, selecione uma opção de formatação. A janela de visualização mostra um exemplo da opção selecionada. Quando você altera uma configuração selecionando um botão de opção ou marcando uma caixa de seleção, a janela de visualização é atualizada para mostrar o efeito da nova configuração.

Página Formatação (Geral)

Configurações gerais

Essas configurações afetam quando o editor de códigos aplica opções de formatação ao código.

Rótulo Descrição
Formatar automaticamente ao digitar Quando estiver desmarcada, as opções formatar instrução em ; e formatar bloco em } estarão desabilitadas.
Formatar instrução automaticamente em ; Quando selecionada, formata as instruções na conclusão de acordo com as opções de formatação selecionadas para o editor.
Formatar bloco automaticamente em } Quando selecionada, formata blocos de código de acordo com as opções de formatação selecionadas para o editor assim que você conclui o bloco de código.
Formatar automaticamente na devolução Quando selecionada, formata o texto quando Enter é pressionado, de acordo com as opções de formatação selecionadas para o editor.
Formatar automaticamente ao colar Quando selecionada, formata o texto que é colado no editor de acordo com as opções de formatação selecionadas para o editor.

Se você aplicou as configurações de estilo de código para arquivos C# usando o comando Formatar Documento no Visual Studio 2017, essa funcionalidade agora está disponível como Limpeza de Código.

Configurações de Formatar Documento

Essas configurações definem o comando Formatar Documento para executar a limpeza de código adicional em um arquivo. Para obter mais informações sobre como essas configurações são aplicadas, confira Comando Formatar Documento.

Rótulo Descrição EditorConfig e ferramentas correspondentes > Regras de opções
Aplicar todas as regras de formatação de C# (recuo, quebra automática, espaçamento) O comando Formatar Documento sempre corrige os problemas de formatação. Essa configuração não pode ser alterada. Principais opções do EditorConfig
Opções de formatação do EditorConfig do .NET

Ferramentas > do Opções > do Editor > de texto C# > Formatando > [recuo ou novas linhas ou espaçamento ou disposição]
Executar limpeza de código de adição durante a formatação Quando selecionada, aplica correções para as regras especificadas abaixo no comando Edit.FormatDocument. N/D
Remover using desnecessários Quando selecionada, remove as diretivas using desnecessários quando Edit.FormatDocument é disparado. N/D
Classificar usando Quando selecionada, classifica as diretivas using quando Edit.FormatDocument é disparado. dotnet_sort_system_directives_first

Ferramentas > do Opções > do Editor > de texto C# > Avançado > Coloque as diretivas ' System ' primeiro ao classificar usando
Adicionar/remover chaves de instruções de controle de única linha Quando selecionado, adiciona ou remove as chaves das instruções de controle de única linha quando Edit.FormatDocument é disparado. csharp_prefer_braces

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código Preferências de bloco de código > Preferir chaves
Adicionar modificadores de acessibilidade Quando selecionada, adiciona os modificadores de acessibilidade ausentes quando Edit.FormatDocument é disparado. dotnet_style_require_accessibility_modifiers
Classificar modificadores de acessibilidade Quando selecionada, classifica os modificadores de acessibilidade quando Edit.FormatDocument é disparado. csharp_preferred_modifier_order
visual_basic_preferred_modifier_order
Aplicar preferências de corpo de expressão/bloco Quando selecionada, converte os membros no corpo da expressão em corpos de bloco, ou vice-versa, quando Edit.FormatDocument é disparado. Opções do EditorConfig para membro no corpo da expressão

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código Preferências > de expressão Use o corpo da expressão para métodos, construtores, etc.
Aplicar preferências de tipo implícitas/explícitas Quando selecionada, converte var no tipo explícito, ou vice-versa, quando Edit.FormatDocument é disparado. Opções do EditorConfig para tipo explícito

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código preferências de ' var '
Aplicar preferências de variáveis 'out' embutidas Quando selecionada, embute as variáveis out onde possível quando Edit.FormatDocument é disparado. csharp_style_inlined_variable_declaration

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código Preferências > de variáveis Preferir declaração de variável embutida
Aplicar preferências de tipo de linguagem/estrutura Quando selecionada, converte tipos de linguagem em tipos de estrutura, ou vice-versa, quando Edit.FormatDocument é disparado. dotnet_style_predefined_type_for_locals_parameters_members
dotnet_style_predefined_type_for_member_access

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código preferências de tipo predefinidas
Aplicar preferências de inicialização de objeto/coleção Quando selecionada, usa os inicializadores de objeto e de coleção sempre que possível quando Edit.FormatDocument é disparado. dotnet_style_object_initializer
dotnet_style_collection_initializer

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código Preferências > de expressão Preferir inicializador de objeto ou o inicializador de coleção preferir
Aplicar preferências de qualificação 'this.' Quando marcada, aplica as preferências de this. quando Edit.FormatDocument é disparado. Opções do EditorConfig para a qualificação this.

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código Preferências ' this. '
Tornar campos particulares readonly quando possível Quando selecionada, torna os campos particulares readonly sempre que possível quando Edit.FormatDocument é disparado. dotnet_style_readonly_field

Ferramentas > do Opções > do Editor > de texto C# > Estilo > do código Preferências > de campo Preferir ReadOnly
Remover conversões desnecessárias Quando selecionada, remove as conversões desnecessárias sempre que possível quando Edit.FormatDocument é disparado. N/D
Remover variáveis não usadas Quando selecionada, remove as variáveis que não são usadas quando Edit.FormatDocument é disparado. N/D

Configurações de limpeza de código para C# no Visual Studio

Página Recuo

As opções de recuo nessa página se aplicam quando o código é formatado automaticamente. Um exemplo de quando o código é formatado automaticamente é quando você cola o código no arquivo e a opção Formatar automaticamente ao colar está selecionada. (A opção Formatar automaticamente ao colar está sob Formatação > Geral.)

Opções de recuo do editor de texto em C# no Visual Studio

Dica

Também há opções de recuo na página de opções Guias do Editor de Texto > C#. > Essas opções determinam apenas onde o editor de códigos coloca o cursor quando você pressiona Enter no final de uma linha.

Opções de guias do editor de texto em C# no Visual Studio

Confira também