Creazione di un progetto (Visual C#)

Aggiornamento: novembre 2007

Prima di avviare l'operazione di codifica è necessario impostare un progetto. Nel progetto sono contenuti tutti gli elementi fondamentali per l'applicazione, ad esempio i file di codice sorgente, i file di risorse quali icone, riferimenti a file esterni da cui dipende il programma e dati di configurazione come le impostazioni del compilatore. Quando si genera un progetto, Visual C# richiama il compilatore C# e altri strumenti interni per creare un assembly eseguibile utilizzando i file contenuti nel progetto.

Creazione di un nuovo progetto

Per creare un nuovo progetto scegliere Nuovo dal menu File e quindi Progetto.

Nota:

Se si sceglie Sito Web anziché Progetto, verrà aperto l'ambiente di sviluppo integrato (IDE, Integrated Development Environment) di Visual Web Developer. Si tratta di un ambiente separato e distinto all'interno di Visual Studio per la creazione di applicazioni Web ASP.NET. Nell'IDE di Visual Web Developer viene utilizzato l'editor di codice di Visual C# per la modifica dei file code-behind in C#. Se si creano applicazioni Web, è necessario utilizzare principalmente la documentazione relativa a Visual Web Developer, ma è consigliabile vedere Modifica di codice (Visual C#) per informazioni relative all'editor C#.

Di seguito è illustrata la finestra di dialogo Nuovo progetto. Per impostazione predefinita, Visual C# è selezionato nella finestra a sinistra, mentre a destra sono presenti i modelli di progetto che è possibile selezionare. Se si espande e si fa clic sul un nodo a sinistra, sul lato destro sarà possibile visualizzare diversi tipi di progetto. L'elenco dei modelli di progetto dipende in parte dalla versione di Visual Studio in uso. 

È possibile selezionare la versione di .NET Framework per il progetto nella finestra di dialogo Nuovo progetto La versione di .NET Framework selezionata nella finestra di dialogo Nuovo progetto è la versione richiesta per consentire l'esecuzione dell'applicazione nel computer. Per ulteriori informazioni, vedere .Cenni preliminari sulla scelta di una versione specifica di .NET Framework.

Finestra di dialogo Nuovo progetto per C#

Dopo avere selezionato un modello di progetto e avere scelto OK, in Visual Studio verrà creato il progetto e sarà possibile iniziare la codifica. I file, i riferimenti, le impostazioni e le risorse del progetto sono visibili sul lato destro nella finestra Esplora soluzioni.

I file del progetto visualizzati nel riquadro Esplora soluzioni

Contenuto di un progetto

Proprietà

Il nodo Proprietà rappresenta le impostazioni di configurazione applicate all'intero progetto e archiviate nel file csproj nella cartella della soluzione. In queste impostazioni sono incluse, tra le altre, le opzioni di compilazione e le impostazioni di sicurezza e distribuzione. È possibile modificare il progetto tramite Progettazione progetti, un insieme di pagine delle proprietà a cui è possibile accedere facendo clic con il pulsante destro del mouse su Proprietà, quindi scegliendo Apri. Per ulteriori informazioni, vedere Modifica delle proprietà di un progetto (Visual C#).

riferimenti

Nel contesto di un progetto, con il termine riferimento si indica un file binario necessario per l'esecuzione dell'applicazione. Generalmente un riferimento indica un file DLL, ad esempio un file della libreria di classi .NET Framework. Può anche indicare un assembly .NET (denominato shim) che consente all'applicazione di chiamare metodi su un oggetto COM o su una DLL Win32 nativa. Se viene creata un'istanza di una classe definita in un altro assembly, è necessario aggiungere un riferimento a tale file nel progetto prima di avviarne la compilazione. Per aggiungere un riferimento, scegliere Aggiungi riferimento dal menu Progetto. Per impostazione predefinita, tutti i progetti C# includono un riferimento a mscorlib.dll, una libreria contenente le classi .NET Framework di base. È possibile aggiungere riferimenti a DLL .NET Framework aggiuntive e ad altri file scegliendo Aggiungi riferimento dal menu Progetto.

Nota:

È importante non confondere il concetto di riferimento di un progetto con il concetto di tipi di riferimento in C# o in altri linguaggi di programmazione. Il primo si riferisce a un file e al relativo percorso previsto nel disco. Il secondo si riferisce ai tipi di C# che vengono dichiarati tramite la parola chiave class.

Risorse

Una risorsa è costituita da dati forniti con l'applicazione archiviabili in modo da poter essere modificati in modo indipendente rispetto al codice sorgente rimanente. Ad esempio, è possibile archiviare tutte le stringhe come risorse anziché impostarle come hardcoded nel codice sorgente. Sarà in seguito possibile convertire le stringhe in linguaggi diversi e aggiungerle alla cartella dell'applicazione che viene fornita ai clienti senza dover ricompilare l'assembly. I cinque tipi di risorse definiti da Visual C# sono i seguenti: stringhe, immagini, icone, audio e file. È possibile aggiungere, rimuovere o modificare le risorse tramite Progettazione risorse, accessibile dalla scheda Risorse di Progettazione progetti.

Form

Quando si crea un progetto Windows Form, per impostazione predefinita Visual C# aggiunge un form al progetto, denominandolo Form1. I due file che rappresentano il form sono denominati Form1.cs e Form1.designer.cs. Nel file Form1.cs è possibile scrivere il codice personalizzato, mentre nel file designer.cs il codice che implementa tutte le azioni eseguite trascinando i controlli selezionati dalla Casella degli strumenti viene scritto da Progettazione Windows Form.

È possibile aggiungere un nuovo form scegliendo Progetto, quindi Aggiungi Windows Form. A ogni form sono associati due file. Il file denominato Form1.cs, o in qualsiasi altro modo scelto dall'utente, contiene il codice sorgente che viene scritto per configurare il form e i relativi controlli, ad esempio caselle di riepilogo e caselle di testo, e risponde agli eventi quali selezioni di pulsanti e sequenze di tasti. Nei progetti Windows Form semplici quasi tutte le operazioni di codifica vengono eseguite in questo file.

Il file designer.cs contiene il codice sorgente scritto da Progettazione form quando si trascinano i controlli nel form, si impostano le proprietà nella finestra Proprietà e così via. Generalmente, non è necessaria alcuna modifica manuale in questo file.

Nota:

Naturalmente, se si crea un progetto di applicazione console, quest'ultimo non conterrà file di codice sorgente per Windows Form.

Altri file di codice sorgente

Un progetto può includere qualsiasi numero di file con estensione cs aggiuntivi che potrebbero essere associati a un particolare Windows Form. Nell'illustrazione precedente di Esplora soluzioni il file program.cs contiene il punto di ingresso per l'applicazione. In un unico file cs può essere contenuto un qualsiasi numero di definizioni di classi e di strutture. È possibile aggiungere al progetto classi o file nuovi o esistenti scegliendo Aggiungi nuovo elemento o Aggiungi elemento esistente dal menu Progetto.

Vedere anche

Attività

Procedura: creare configurazioni della build di soluzioni e progetti

Procedura: creare un progetto applicazione Windows

Concetti

Introduzione a soluzioni, progetti ed elementi

Utilizzo di Esplora soluzioni

File di progetto nascosti in Esplora soluzioni

Controllo di progetti e soluzioni

Altre risorse

Visual C#

Utilizzo dell'IDE di Visual C#