Informazioni su come usare l'editor di codice con C#

In questa introduzione di 10 minuti all'editor di codice in Visual Studio si aggiungerà codice a un file per esaminare alcuni dei modi in cui Visual Studio semplifica la scrittura, lo spostamento e la comprensione del codice C#.

Se non è ancora stato installato Visual Studio, accedere alla pagina Download di Visual Studio per installarlo gratuitamente.

Questa articolo presuppone una certa familiarità con C#. Se non si possiede questa familiarità, è consigliabile seguire prima un'esercitazione, ad esempio Introduzione a C# e ad ASP.NET Core in Visual Studio.

Suggerimento

Per poter seguire questo articolo, assicurarsi che le impostazioni di C# siano selezionate per Visual Studio. Per informazioni sulla selezione delle impostazioni per l'ambiente di sviluppo integrato (IDE), vedere Select environment settings (Selezionare le impostazioni di ambiente).

Creare un nuovo file di codice

Per iniziare si crea un nuovo file e si aggiunge codice al file.

  1. Aprire Visual Studio. Premere ESC oppure fare clic su Continua senza codice nella finestra iniziale per aprire l'ambiente di sviluppo.

  2. Scegliere Nuovo>file dal menu File sulla barra dei menu oppure premere CTRL+N.

  3. Nella finestra di dialogo Nuovo file, nella categoria Generale, scegliere Classe di Visual C# e quindi scegliere Apri.

    Nell'editor viene aperto un nuovo file con lo scheletro di una classe C#. Si noti che non è necessario creare un progetto di Visual Studio completo per ottenere alcuni dei vantaggi che offre l'editor di codice. È sufficiente un file di codice.

    Screenshot of a C# code file in Visual Studio.

  1. Aprire Visual Studio. Premere ESC o scegliere Continua senza codice nella finestra iniziale per aprire l'ambiente di sviluppo.

  2. Scegliere Nuovo>file dal menu File sulla barra dei menu oppure premere CTRL+N.

  3. Nella finestra di dialogo Nuovo file, nella categoria Generale, scegliere Classe di Visual C# e quindi scegliere Apri.

    Nell'editor viene aperto un nuovo file con lo scheletro di una classe C#. Non è necessario creare un progetto di Visual Studio completo per ottenere alcuni dei vantaggi offerti dall'editor di codice, tutto ciò che serve è un file di codice.

    Screenshot of a C# code file in Visual Studio 2022.

Usare frammenti di codice

Visual Studio offre frammenti di codice utili che è possibile usare per generare in modo semplice e rapido blocchi di codice di uso comune. I frammenti di codice sono disponibili per vari linguaggi di programmazione, tra cui C#, Visual Basic e C++.

Ora si aggiunge il frammento C# void Main al file.

  1. Posizionare il cursore appena sopra la parentesi graffa di chiusura finale } nel file e digitare i caratteri svm (che sta per static void Main- non preoccuparsi troppo se non si sa cosa significa).

    Verrà visualizzata una finestra di dialogo a comparsa con le informazioni sul frammento di codice svm.

    Screenshot of an IntelliSense pop-up for a code snippet in Visual Studio.

  2. Premere due volte TAB per inserire il frammento di codice.

    La firma del metodo static void Main() viene aggiunta al file. Il metodo Main() è il punto di ingresso per le applicazioni C#.

I frammenti di codice disponibili variano a seconda del linguaggio di programmazione. È possibile esaminare i frammenti di codice disponibili per il linguaggio scegliendo Modifica>intelliSense>Inserisci frammento di codice o premendo CTRL+K, CTRL+X e quindi scegliendo la cartella del linguaggio. Per C# l'elenco ha l'aspetto seguente:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

  1. Posizionare il cursore } appena sopra la parentesi graffa di chiusura finale nel file e digitare i caratteri svm. svm sta per static void Main- non preoccuparti se non sai cosa significa ancora.

    Verrà visualizzata una finestra di dialogo a comparsa con le informazioni sul frammento di codice svm.

    Screenshot of an IntelliSense pop-up for a code snippet in Visual Studio 2022.

  2. Premere due volte TAB per inserire il frammento di codice.

    Verrà visualizzata la firma del static void Main() metodo aggiunta al file. Il metodo Main() è il punto di ingresso per le applicazioni C#.

I frammenti di codice disponibili variano per i diversi linguaggi di programmazione. È possibile esaminare i frammenti di codice disponibili per il linguaggio scegliendo Modifica>intelliSense>Inserisci frammento o premendo CTRL K, CTRL++X e quindi scegliendo la cartella per il linguaggio di programmazione. Per C#, l'elenco dei frammenti di codice è simile al seguente:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

L'elenco include frammenti per la creazione di una classe, un costruttore, un ciclo for, un'istruzione if o switch e altro ancora.

Codice di impostazione come commento

La barra degli strumenti, ovvero la riga di pulsanti sotto la barra dei menu di Visual Studio, contribuisce ad aumentare la produttività in fase di creazione del codice. Ad esempio, è possibile attivare o disattivare la modalità di completamento IntelliSense (IntelliSense è un ausilio per la scrittura del codice che visualizza un elenco di metodi corrispondenti, tra le altre cose), aumentare o ridurre un rientro di riga o impostare come commento il codice che non si vuole compilare. In questa sezione, una porzione del codice verrà impostata come commento.

Screenshot of the Editor toolbar in Visual Studio.

  1. Incollare il codice seguente nel corpo del metodo Main().

    // _words is a string array that we'll sort alphabetically
    string[] _words = {
        "the",
        "quick",
        "brown",
        "fox",
        "jumps"
    };
    
    string[] morewords = {
        "over",
        "the",
        "lazy",
        "dog"
    };
    
    IEnumerable<string> query = from word in _words
                                orderby word.Length
                                select word;
    
  2. In questa fase non si usa la variabile morewords ma, poiché potrebbe risultare utile in seguito, non la si elimina. Invece si impostano le linee corrispondenti come commento. Selezionare l'intera definizione di al punto e virgola di morewords chiusura e quindi scegliere il pulsante Commento per le righe selezionate sulla barra degli strumenti. Se si preferisce usare la tastiera, premere Ctrl+K, Ctrl+C.

    Screenshot of the Comment out button in the Editor toolbar in Visual Studio.

    I caratteri del commento di C# // vengono aggiunti all'inizio di ogni linea selezionata per impostare la linea come codice.

La barra degli strumenti, ovvero la riga dei pulsanti sotto la barra dei menu in Visual Studio, consente di aumentare la produttività durante il codice. Ad esempio, è possibile attivare o disattivare la modalità di completamento di IntelliSense , aumentare o diminuire un rientro di riga o impostare come commento il codice che non si vuole compilare.

Screenshot of the Text Editor toolbar in Visual Studio 2022.

Aggiungere un commento al codice.

  1. Incollare il codice seguente nel corpo del metodo Main().

    // someWords is a string array.
    string[] someWords = {
        "the",
        "quick",
        "brown",
        "fox",
        "jumps"
    };
    
    string[] moreWords = {
        "over",
        "the",
        "lazy",
        "dog"
    };
    
    // Alphabetically sort the words.
    IEnumerable<string> query = from word in someWords
                                orderby word
                                select word;
    
  2. La variabile non viene usata moreWords , ma potrebbe essere usata in un secondo momento, quindi non si vuole eliminarla. Queste righe verranno invece commentato. Selezionare l'intera definizione di fino al punto e virgola di moreWords chiusura e quindi scegliere il pulsante Commento per le righe selezionate sulla barra degli strumenti. Se si preferisce usare la tastiera, premere CTRL+E, CTRL+C.

    Screenshot of the Comment out button in the Text Editor toolbar in Visual Studio 2022.

    I caratteri del commento di C# // vengono aggiunti all'inizio di ogni linea selezionata per impostare la linea come codice.

Comprimere i blocchi di codice

Non si vuole visualizzare il costruttore vuoto generato per Class1, in modo da non comprimere la visualizzazione del codice, comprimerlo. Scegliere la piccola casella grigia contenente il segno meno sul margine della prima riga del costruttore. In alternativa, se si preferisce usare la tastiera, posizionare il cursore in qualsiasi punto del codice del costruttore e premere CTRL+M, CTRL+M.

Screenshot of the Outlining collapse button in the Text Editor toolbar in Visual Studio.

Il blocco di codice viene compresso e visualizza solo la prima riga seguita dai puntini di sospensione (...). Per espandere di nuovo il blocco di codice fare clic sulla stessa casella grigia, che ora contiene un segno più, oppure premere di nuovo CTRL+M, CTRL+M. Questa funzionalità è detta Gestione della struttura ed è particolarmente utile per comprimere metodi con molto codice o intere classi.

Screenshot of the Outlining collapse button in the Text Editor toolbar in Visual Studio 2022.

Il blocco di codice viene compresso e visualizza solo la prima riga seguita dai puntini di sospensione (...). Per espandere di nuovo il blocco di codice, selezionare la stessa casella grigia con un segno più oppure premere di nuovo CTRL+M, CTRL+M. Questa funzionalità è detta Gestione della struttura ed è particolarmente utile per comprimere metodi con molto codice o intere classi.

Visualizzare le definizioni dei simboli

L'editor di Visual Studio semplifica l'ispezione della definizione di un tipo, di un metodo e così via. Un modo consiste nel passare al file che contiene la definizione, ad esempio scegliendo Vai a definizione o premendo F12 in qualsiasi punto a cui si fa riferimento al simbolo. Un metodo ancora più veloce che non sposta lo stato attivo dal file in uso è rappresentato da Visualizza definizione. Di seguito si procede a visualizzare la definizione del tipo string.

  1. Fare clic con il pulsante destro del mouse su una qualsiasi ricorrenza di string e scegliere Visualizza definizione dal menu del contenuto. In alternativa, premere Alt+F12.

    Viene visualizzata una finestra popup con la definizione della classe String. È possibile scorrere all'interno della finestra popup o anche esaminare la definizione di un altro tipo dal codice visualizzato.

    Screenshot of a Peek definition window in Visual Studio.

  2. Chiudere la finestra di visualizzazione della definizione scegliendo la piccola casella contenente una "x" nell'angolo in alto a destra della finestra popup.

L'editor di Visual Studio semplifica l'ispezione della definizione di un tipo, di un metodo o di una variabile. Un modo consiste nell'andare alla definizione, a ogni file a cui fa riferimento, scegliendo Vai a definizione o premendo F12 in qualsiasi punto a cui viene fatto riferimento un simbolo. Un modo ancora più rapido che non sposta lo stato attivo dal codice su cui si sta lavorando consiste nell'usare Peek Definition.

Di seguito si procede a visualizzare la definizione del tipo string.

  1. Fare clic con il pulsante destro del mouse su una qualsiasi ricorrenza di string e scegliere Visualizza definizione dal menu del contenuto. In alternativa, premere Alt+F12.

    Viene visualizzata una finestra popup con la definizione della classe String. È possibile scorrere all'interno della finestra popup o anche esaminare la definizione di un altro tipo dal codice visualizzato.

    Screenshot of the Peek definition window in Visual Studio 2022.

  2. Chiudere la finestra di visualizzazione della definizione scegliendo la piccola casella con una "x" in alto a destra della finestra popup.

Usare IntelliSense per il completamento di parole

IntelliSense è una risorsa molto importante per la creazione di codice. Consente di visualizzare informazioni sui membri disponibili di un tipo o sui dettagli parametro per diversi overload di un metodo. È anche possibile usare IntelliSense per completare una parola dopo aver digitato un numero di caratteri sufficiente a evitare ambiguità. Aggiungere una riga di codice per stampare le stringhe ordinate nella finestra della console, ovvero la posizione standard in cui finisce l'output del programma.

  1. Sotto la variabile query iniziare a digitare il codice seguente:

    foreach (string str in qu
    

    IntelliSense visualizza informazioni rapide sul simbolo query.

    Screenshot of an IntelliSense word completion pop-up in Visual Studio.

  2. Per inserire il resto della parola query mediante la funzionalità di completamento della parola di IntelliSense premere TAB.

  3. Completare il blocco di codice in modo che abbia un aspetto simile al codice seguente. È anche possibile esercitarsi ulteriormente nell'uso di frammenti di codice immettendo cw e quindi premendo TAB due volte per generare il codice Console.WriteLine.

    foreach (string str in query)
    {
       Console.WriteLine(str);
    }
    

IntelliSense è una risorsa molto importante per la creazione di codice. Consente di visualizzare informazioni sui membri disponibili di un tipo o sui dettagli parametro per diversi overload di un metodo. È anche possibile usare IntelliSense per completare una parola dopo aver digitato un numero di caratteri sufficiente a evitare ambiguità.

Aggiungere una riga di codice per stampare le stringhe ordinate nella finestra della console, ovvero la posizione standard in cui finisce l'output del programma.

  1. Sotto la variabile query iniziare a digitare il codice seguente:

    foreach (string str in qu
    

    Verrà visualizzato un popup IntelliSense con informazioni sul query simbolo.

    Screenshot of an IntelliSense word completion pop-up in Visual Studio 2022.

  2. Per inserire il resto della parola usando il completamento della parola query IntelliSense, premere TAB.

  3. Completare il blocco di codice in modo che abbia un aspetto simile al codice seguente. È possibile esercitarsi ulteriormente con i frammenti di codice immettendo cw e quindi premendo TAB due volte per generare l'istruzione Console.WriteLine .

    foreach (string str in query)
    {
       Console.WriteLine(str);
    }
    

Effettuare il refactoring di un nome

Quando si inizia a creare codice è facile commettere errori e quindi dover modificare il nome di una variabile o di un metodo. Ora si userà la funzionalità refactoring di Visual Studio per rinominare la variabile _words come words.

  1. Posizionare il cursore sulla definizione della variabile _words, quindi scegliere Rinomina dal menu di scelta rapida o dal menu a comparsa oppure premere CTRL+R, CTRL+R.

    Nella parte superiore destra dell'editor viene visualizzata la finestra di dialogo popup Rinomina.

  2. Immettere le parole del nome desiderato. Si noti che anche il riferimento a words nella query viene rinominato automaticamente. Prima di premere INVIO selezionare la casella di controllo Includi commenti nella finestra popup Rinomina.

    Screenshot of a Rename dialog box in Visual Studio.

  3. Premere INVIO.

    Entrambe le ricorrenze di words sono state rinominate, e così anche il riferimento a words nel commento del codice.

Quando si inizia a creare codice è facile commettere errori e quindi dover modificare il nome di una variabile o di un metodo. Ora si userà la funzionalità refactoring di Visual Studio per rinominare la variabile someWords come unsortedWords.

  1. Posizionare il cursore sulla definizione della someWords variabile e scegliere Rinomina dal menu di scelta rapida o fare clic con il pulsante destro del mouse oppure premere F2.

    Viene visualizzata una finestra di dialogo Rinomina in alto a destra dell'editor.

    Screenshot of the Rename pop-up box within the editor of Visual Studio 2022.

  2. Immettere il nome desiderato unsortedWords. Si noterà che anche il riferimento a unsortedWords nell'istruzione query di assegnazione viene rinominato automaticamente. Prima di premere INVIO selezionare la casella di controllo Includi commenti nella finestra popup Rinomina.

    Screenshot of the Rename pop-up box in Visual Studio 2022.

  3. Premere INVIO oppure scegliere Applica nella finestra di dialogo Rinomina .

    Entrambe le occorrenze di someWords nel codice sono state rinominate, nonché il testo someWords nel commento del codice.

Passaggi successivi

Vedi anche