Informazioni sul correttore ortografico

Molte delle funzionalità di Visual Studio sono progettate per facilitare la scrittura del codice desiderato, assicurandosi che il codice venga compilato per semplificare lo stile del codice. Ora, con la funzionalità Controllo ortografico, introdotta nella versione 17.5, Visual Studio può anche assicurarsi che l'ortografia sia accurata.

Il correttore ortografico è disponibile per qualsiasi file C#, C++o Markdown. Quando il correttore ortografico è abilitato, Visual Studio contrassegna tutte le parole rilevate come parole con errori di ortografia. Visual Studio suggerisce anche ortografie alternative e consente di correggerle. La funzionalità esegue anche una ridenominazione contestuale quando questi errori di ortografia sono identificatori in modo che il codice continui a essere compilato.

È possibile disattivare o attivare il correttore ortografico usando il pulsante Attiva/Disattiva controllo ortografico sulla barra degli strumenti principale oppure selezionando Modifica>controllo ortografico avanzato> dalla barra dei menu.

Come si usa?

Quando il cursore si trova in un errore ortografico, le azioni rapide forniscono soluzioni per correggere gli errori di ortografia. È possibile visualizzare le azioni rapide usando i tasti di scelta rapida CTRL+ o ALT+INVIO. Quando viene visualizzato il menu di scelta rapida, Visual Studio visualizza tre opzioni per gestire un problema di ortografia.

Se uno dei dizionari fornisce suggerimenti ortografici, Visual Studio li visualizza. Se più dizionari forniscono suggerimenti, Visual Studio raggruppa i suggerimenti in base al dizionario. Per le stringhe e i commenti, la scelta di uno di questi suggerimenti comporta una sola sostituzione sul posto. Per gli identificatori in un documento C++ o C#, l'accettazione di un suggerimento comporta un refactoring/ridenominazione che aggiorna tutte le istanze dell'identificatore per assicurarsi che il codice venga compilato.

È anche possibile scegliere di ignorare il problema di ortografia. Scegliendo di ignorare il problema, Visual Studio crea un file exclusion.dic nella directory AppData nel computer locale. Dopo aver scelto di ignorare una parola, il correttore ortografico lo ignora in tutte le istanze di Visual Studio.

Come funziona?

Poiché C#, C++e Markdown usano tutti l'inglese come lingua per le relative parole chiave, Visual Studio usa in genere il dizionario "Inglese (Stati Uniti)" o "en-us" per il controllo ortografico. Visual Studio controlla l'istanza di Windows per la lingua di visualizzazione in uso e, se non è "en-us", usa anche tale dizionario.

Nota

C# e C++ hanno anche dizionari aggiuntivi per le parole chiave in tali linguaggi, che impediscono che parole come "spazio dei nomi" o "alloc" vengano contrassegnate come parole con errori di ortografia.

Il feedback dei primi utenti di questa funzionalità ci ha informato che gli sviluppatori vogliono sapere solo gli errori nel documento con cui stanno lavorando. In risposta a tale feedback, il correttore ortografico analizza solo i documenti attivi nell'editor.

La tabella seguente illustra alcune delle euristiche esaminate dal correttore ortografico durante l'analisi di un documento di codice:

Contenuto del codice	Controlli di Visual Studio	Perché?
Ciao	Ciao, ciao	Controllare sempre sia i sostantivi appropriati che i sostantivi comuni
HelloWorld	Hello, hello, World, world	Le maiuscole mediali vengono usate per contrassegnare i limiti delle parole
Hello.World	Hello, hello, World, world	La punteggiatura viene usata come limite di parola
_Hello123	Ciao, ciao	Numeri iniziali o finali o segni di punteggiatura vengono rimossi
Hello2World	Hello, hello, World, world	I numeri mediali, come i segni di punteggiatura, vengono usati come limite di parola
btnWorld	Mondo, mondo	I frammenti di tre caratteri o meno vengono ignorati
helloworld	Helloworld, helloworld	Nessun indicatore per identificare i limiti delle parole

Se Visual Studio identifica una corrispondenza per il token in uno dei dizionari in uso, il token viene considerato accettabile e l'analisi procede. In caso contrario, il token viene considerato errato e Visual Studio lo contrassegna come errore ortografico.

Come personalizzare il correttore ortografico

È possibile personalizzare il correttore ortografico in modo che sia ottimizzato per un ambiente collaborativo. Di conseguenza, Visual Studio usa un file EditorConfig per la configurazione in modo da poter controllare il comportamento del correttore ortografico in un repository.

Configurando un file EditorConfig, è possibile stabilire gli standard di codifica che si prevede che tutti gli utenti seguano, in modo da mantenere una coerenza di codifica che potrebbe essere difficile tramite altri metodi.

Importante

Le opzioni di errore ortografico sono specifiche del file. È necessario specificare le opzioni di ortografia dei file a cui vengono applicate. Nell'esempio seguente le opzioni di ortografia vengono applicate a tutti i file C# nella soluzione:

[*.cs]

Ecco alcuni esempi e scenari di casi d'uso delle opzioni che è possibile configurare in un file EditorConfig:

• Elencare le lingue da usare per Visual Studio. In questo esempio Visual Studio usa solo i dizionari "en-us" e "fr-fr" durante il controllo dei problemi di ortografia.

  spelling_languages = _language_[,_language_]
(Example: = en-us,fr-fr)

  Nota

  Assicurarsi di installare il Language Pack per qualsiasi lingua in uso per impedire a Visual Studio di contrassegnare erroneamente le parole come errori di ortografia.

• Controllare il controllo di Visual Studio. In questo esempio Visual Studio controlla gli identificatori e i commenti per individuare parole con errori di ortografia, ma non controllano all'interno di stringhe.

  spelling_checkable_types = strings,identifiers,comments
(Example: = identifiers,comments)

• Controllare la gravità assegnata da Visual Studio agli errori ortografici nell'elenco degli errori. In questo esempio gli errori ortografici vengono visualizzati come errori.

  spelling_error_severity = error OR warning OR information OR hint
(Example: = error)

• Creare un dizionario di esclusione personalizzato per specificare le parole che si considerano digitate correttamente. In questo esempio, la prima volta che il correttore ortografico viene eseguito su qualsiasi file nella soluzione, Visual Studio verifica la presenza di un file exclusion.dic. Visual Studio controlla la stessa directory del file .sln per un progetto C# o nella directory radice per una directory C++. Se non esiste alcun file exclusion.dic, visual Studio ne crea uno. Quindi, ogni volta che l'utente sceglie di ignorare una parola, Visual Studio lo aggiunge a questo file exclusion.dic. Visual Studio considera qualsiasi parola visualizzata in questo file exclusion.dic come parola digitata correttamente.

  spelling_exclusion_path = absolute OR relative path to exclusion dictionary
(Example: = .\exclusion.dic)

  Nota

  Visual Studio usa il dizionario di esclusione specificato dall'opzione spelling_exclusion_path nel file con estensione editorconfig o in un file exclusion.dic nella %localappdata%\Microsoft\VisualStudio\<Version> directory se non è possibile trovare un'opzione.

• Controllare se viene usato il dizionario di esclusione specifico della lingua predefinito. Questo flag è impostato su true per impostazione predefinita. Tutte le parole aggiunte al dizionario di esclusione specifico della lingua verranno considerate correttamente digitate. Impostare su false per ignorare i dizionari di esclusione specifici di C++ o C#.

  spelling_use_default_exclusion_dictionary = true OR false
(Example: = spelling_use_default_exclusion_dictionary = false)

Ecco un esempio completo:

[*.{cs,vb}]                                         //specify which files the spelling options apply to
spelling_languages = en-us,fr-fr                    //specifies the en-us and fr-fr dictionaries for use in spell checking
spelling_checkable_types = identifiers,comments     //specifies that identifiers and comments are the only checked elements
spelling_error_severity = error                     //sets severity assigned to spelling errors to error in the error list
spelling_exclusion_path = exclusion.dic             //defines a custom exclusion dictionary location and file
spelling_use_default_exclusion_dictionary = false   //ignores the language-specific default exclusion dictionary

Gestione dei casi speciali

Visual Studio presenta alcuni comportamenti univoci durante il controllo degli errori ortografici che differiscono da quelli di un tradizionale correttore ortografico progettato per il testo scritto. Alcuni di questi comportamenti includono:

• In una stringa che include la punteggiatura, ad esempio "misc.", Visual Studio non suggerisce una correzione perché la punteggiatura in un identificatore potrebbe generare codice che non viene compilato.
• Le barre rovesciate in una stringa ometteranno il carattere successivo dal controllo ortografico e tratteranno la barra rovesciata e il carattere successivo come delimitatore di parola. Ad esempio, nella stringa hello\nworld, Visual Studio rileva prima la barra rovesciata. Visual Studio considera l'oggetto \n come delimitatore di parole, che lascia "hello" e "world", ognuno dei quali viene controllato singolarmente.
• Le stringhe che contengono URL, ad https://... esempio o mailto:.. non verranno controllate in modo ortografico sull'intera stringa.

Contenuto correlato

• Miglioramento del correttore ortografico