Opções, Editor de Texto, C#, Avançado

Use a página Opções avançadas para modificar as configurações de formatação do editor, refatoração de código e comentários da documentação XML para C#. Para acessar essa página de opções, escolhaOpções> e escolha Editor> de TextoC#>Avançado.

Observação

Nem todas as opções podem estar listadas aqui.

Temo de

• Executar a análise de código em segundo plano para...

  Escolha uma das opções a seguir.

  Opção	Descrição
  Nenhum	Todos os analisadores e correções de código correspondentes estão desabilitados. O diagnóstico do compilador e as correções de código correspondentes estão habilitados em todos os documentos abertos .
  Documento atual (padrão)	Todos os analisadores são executados apenas no documento ativo no momento. O diagnóstico do compilador está habilitado em todos os documentos abertos .
  Abrir documentos	Todos os analisadores e o diagnóstico do compilador estão habilitados em todos os documentos abertos .
  Solução inteira	Todos os analisadores e o diagnóstico do compilador estão habilitados em todos os documentos da solução, sejam abertos ou fechados.

Usando diretivas

• Coloque as diretivas 'System' primeiro ao classificar os usos

  Quando selecionado, o comando Remover e Classificar Usos no menu de clique com o botão direito do mouse classifica as using diretivas e coloca os namespaces 'System' na parte superior da lista.

  Antes de classificar:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  Após a classificação:

  using System;
  using System.Collections.Generic;
  using System.Linq;
  using AutoMapper;
  using FluentValidation;
  using Newtonsoft.Json;
  

• Separar usando grupos de diretivas

  Quando selecionado, o comando Remover e Classificar Usos no menu de clique com o botão direito do mouse separa as diretivas inserindo using uma linha vazia entre grupos de diretivas que têm o mesmo namespace raiz.

  Antes de classificar:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  Após a classificação:

  using AutoMapper;
  
  using FluentValidation;
  
  using Newtonsoft.Json;
  
  using System;
  using System.Collections.Generic;
  using System.Linq;
  

• Sugerir usos para tipos em assemblies do .NET Framework

• Sugerir usos para tipos em pacotes NuGet

  Quando essas opções são selecionadas, uma Ação Rápida está disponível para instalar um pacote NuGet e adicionar uma using diretiva para tipos não referenciados.

  

• Adicionar ausente usando diretivas na colagem

  Quando essa opção for selecionada, using as diretivas serão adicionadas automaticamente ao código quando você colar um tipo em um arquivo.

Destacando

• Realçar referências ao símbolo sob o cursor

  Quando o cursor é posicionado dentro de um símbolo ou quando você clica em um símbolo, todas as instâncias desse símbolo no arquivo de código são realçadas.

Esboço

• Insira o modo de estrutura de tópicos quando os arquivos abrirem

  Quando selecionado, descreve automaticamente o arquivo de código, que cria blocos recolhidos de código. Na primeira vez que um arquivo for aberto, #regions blocos e blocos de código inativos serão recolhidos.

• Mostrar separadores de linha de procedimento

  O editor de texto indica o escopo visual dos procedimentos. Uma linha é desenhada nos arquivos de origem .cs do projeto em locais listados na tabela a seguir:

  Local no arquivo de origem .cs	Exemplo de localização de linha
  Após o fechamento de um constructo de declaração de bloco	- No final de uma classe, estrutura, módulo, interface ou enumeração - Após uma propriedade, uma função ou um sub - Não entre as cláusulas get e set em uma propriedade
  Após um conjunto de constructos de linha única	- Após as instruções de importação, antes de uma definição de tipo em um arquivo de classe - Após variáveis declaradas em uma classe, antes de qualquer procedimento
  Após declarações de linha única (declarações de nível não bloqueado)	- Após instruções de importação, instruções herdadas, declarações variáveis, declarações de evento, declarações de delegado e instruções de declaração de DLL

Guias de estrutura de blocos

Marque estas caixas de seleção para exibir linhas verticais pontilhadas entre os colchetes ({}) no código. Em seguida, você pode ver facilmente blocos individuais de código para seus constructos de nível de declaração e nível de código.

Comentários

• Gerar comentários da documentação XML para ///

  Quando selecionado, insere os elementos XML para comentários de documentação XML depois de digitar a introdução do /// comentário. Para obter mais informações sobre a documentação XML, consulte Comentários da Documentação XML (Guia de Programação em C#).

Extrair Método

• Não coloque ref ou out no struct personalizado

  Desmarque essa caixa de seleção para evitar a clonagem potencialmente não intencional de structs referenciando objetos struct existentes ao extrair uma expressão em uma chamada de método.

  Exemplo

  Suponha o seguinte class e struct exista em seu código:

  public struct CustomStruct
  {
      private int Count;
  
      public int Bump => ++Count;
  }
  
  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i += cs.Bump;   // select this line
      }
  }
  

  Se a opção "Não colocar ref ou sair no struct personalizado" estiver desmarcada, o recurso "Extrair método" gerará o seguinte:

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         NewMethod(ref cs, ref i);
      }
  
      private static void NewMethod(ref CustomStruct cs, ref int i)
         => i += cs.Bump;
  }
  

  Se a opção "Não colocar ref ou sair no struct personalizado" for marcada, o recurso "Extrair método" gerará o seguinte:

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i = NewMethod(cs, i);
      }
  
      private static int NewMethod(CustomStruct cs, int i)
      {
         i += cs.Bump;
         return i;
      }
  }
  

Dicas embutidas

• Dicas de nome do parâmetro embutido

  Quando selecionado, insere dicas de nome de parâmetro para literais, literais de conversão e instanciações de objeto antes de cada argumento em chamadas de função.

  

• Dicas de tipo embutido

  Quando selecionado, insere dicas de tipo para variáveis com tipos inferidos e tipos de parâmetro lambda.

  

Margem de Herança

• Quando selecionado, adiciona ícones às margens que representam as implementações e substituições do código. Clicar nos ícones de margem de herança exibirá as opções de herança que você pode selecionar para navegar.

  

Consulte também

• Como inserir comentários XML para geração de documentação
• Documente seu código com comentários XML (Guia do C#)
• Definir opções de editor específicas do idioma
• C# IntelliSense