Caixa de diálogo de Opções: Editor de Texto> C# > Estilo de Código > Formatação

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.

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.)

Dica

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

Página Novas Linhas

Use as opções de novas linhas nesta página para controlar se você quer chaves, palavras-chave ou expressões apareçam em novas linhas no editor de código.

Importante

As configurações nesta página podem ser substituídas pelo arquivo .editorconfig. Para saber mais, consulte Criar configurações de editor personalizado e portátil com o EditorConfig.

Confira também

• Caixa de diálogo Geral, Ambiente, Opções