Opzioni, Editor di testo, C#, Avanzate

Usare la pagina di opzioni Avanzate per modificare le impostazioni di formattazione dell'editor, di refactoring del codice e dei commenti in formato documentazione XML per C#. Per accedere a questa pagina di opzioni, scegliere Strumenti>Opzioni e quindi scegliere Editor di testo>C#>Avanzate.

Analisi

Direttive using

• Inserisci prima le direttive 'System' durante l'ordinamento delle direttive using

  Se selezionato, il comando Rimuovi e ordina using nel menu di scelta rapida ordina le direttive using e posiziona gli spazi dei nomi "System" all'inizio dell'elenco.

  Prima di ordinare:

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

  Dopo aver ordinato:

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

• Separa gruppi di direttive using

  Se selezionata, il comando Rimuovi e ordina using nel menu di scelta rapida separa le direttive using inserendo una riga vuota tra gruppi di direttive che hanno lo stesso spazio dei nomi radice.

  Prima di ordinare:

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

  Dopo aver ordinato:

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

• Suggerire l'uso di per i tipi negli assembly .NET Framework

• Suggerisci le direttive using per i tipi in pacchetti NuGet

  Se queste opzioni sono selezionate, è disponibile un'azione rapida per installare un pacchetto NuGet e aggiungere una direttiva using per i tipi senza riferimenti.

  

• Aggiungi direttive using mancanti dopo operazione Incolla

  Quando questa opzione è selezionata, using le direttive verranno aggiunte automaticamente al codice quando si incolla un tipo in un file.

Evidenziazione

• Evidenzia riferimenti a simbolo sotto il cursore

  Quando il cursore viene posizionato all'interno di un simbolo o quando si fa clic su un simbolo, vengono evidenziate tutte le istanze del simbolo nel file di codice.

struttura

• Attiva modalità struttura all'apertura del file

  Se selezionata, visualizza automaticamente la struttura del file di codice che consente di creare blocchi comprimibili del codice. Alla prima apertura di un file, i blocchi #regions e i blocchi di codice inattivi vengono compressi.

• Mostra separatori di riga routine

  L'editor di testo indica l'ambito visivo delle routine. Viene tracciata una linea nei file di origine con estensione cs del progetto nelle posizioni indicate nella tabella seguente:

  Posizione nel file di origine cs	Esempio di posizione della linea
  Dopo la chiusura di un costrutto di dichiarazione di blocco	- Alla fine di una classe, struttura, modulo, interfaccia o enumerazione - Dopo una proprietà, funzione o sub - Non tra le clausole get e set in una proprietà
  Dopo un set di costrutti a riga singola	- Dopo le istruzioni di importazione, prima di una definizione di tipo in un file di classe - Dopo le variabili dichiarate in una classe, prima di qualsiasi routine
  Dopo le dichiarazioni a riga singola (dichiarazioni non block-level)	- Dopo le istruzioni di importazione, le istruzioni inherits, le dichiarazioni di variabili, le dichiarazioni di eventi, le dichiarazioni di delegati e le istruzioni di dichiarazione di DLL

Guide per strutture a blocchi

Selezionare queste caselle di controllo per visualizzare linee verticali punteggiate tra parentesi graffe ({}) nel codice. È quindi possibile visualizzare facilmente singoli blocchi di codice per i costrutti a livello di dichiarazione e a livello di codice.

Commenti

• Genera commenti relativi alla documentazione XML per ///

  Se selezionata, questa opzione inserisce elementi XML per i commenti in formato documentazione XML dopo la digitazione dell'introduzione al commento ///. Per altre informazioni sulla documentazione XML, vedere Commenti in formato documentazione XML (Guida per programmatori C#).

Estrai metodo

• Non inserire out o ref in struct personalizzato

  Deselezionare questa casella di controllo per evitare la clonazione involontaria degli struct tramite il riferimento agli oggetti struct esistenti durante l'estrazione di un'espressione in una chiamata al metodo.

  Esempio

  Si suppone che nel codice esistano struct gli elementi seguenticlass:

  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 l'opzione "Don't put ref or out on custom struct" (Non inserire ref o out nello struct personalizzato) è deselezionata, la funzionalità "Extract method" genera quanto segue:

  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 è selezionata l'opzione "Don't put ref or out on custom struct", la funzionalità "Extract method" genera quanto segue:

  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;
      }
  }
  

Hint inline

• Suggerimenti per i nomi di parametri inline

  Se selezionata, inserisce hint per il nome del parametro per valori letterali, valori letterali di cast e istanze di oggetti prima di ogni argomento nelle chiamate di funzione.

  

• Hint per il tipo inline

  Se selezionata, inserisce hint di tipo per le variabili con tipi dedotti e tipi di parametro lambda.

  

Margine di ereditarietà

• Se selezionata, aggiunge icone ai margini che rappresentano le implementazioni e gli override del codice. Facendo clic sulle icone dei margini di ereditarietà verranno visualizzate le opzioni di ereditarietà che è possibile selezionare per spostarsi.

  

Vedi anche

• Procedura: Inserire commenti XML per la generazione di documentazione
• Documentare il codice con commenti XML (Guida a C#)
• Impostare opzioni dell'editor specifiche del linguaggio
• IntelliSense per C#