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.
