Opzioni, Editor di testo, C#, Avanzate

Articolo
08/25/2023

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.

Nota

È possibile che non tutte le opzioni siano elencate.

Analisi

Eseguire l'analisi del codice in background per ...

Selezionare una delle seguenti opzioni.

Opzione	Description
Nessuna	Tutti gli analizzatori e le correzioni di codice corrispondenti sono disabilitati. La diagnostica del compilatore e le correzioni di codice corrispondenti sono abilitate in tutti i documenti aperti .
Documento corrente (impostazione predefinita)	Tutti gli analizzatori vengono eseguiti solo nel documento attualmente attivo. La diagnostica del compilatore è abilitata in tutti i documenti aperti .
Aprire documenti	Tutti gli analizzatori e la diagnostica del compilatore sono abilitati in tutti i documenti aperti .
Intera soluzione	Tutti gli analizzatori e la diagnostica del compilatore sono abilitati in tutti i documenti della soluzione, sia aperti che chiusi.

Analisi del codice live o Ambito di analisi in background

Configurare l'ambito di analisi in background per il codice gestito. Per altre informazioni, vedere Procedura: Configurare l'ambito di analisi del codice live per il codice gestito.

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.