Pagina Compilazione, Creazione progetti (C#)

  • Articolo

Usare la pagina Compilazione di Creazione progetti per specificare le proprietà di configurazione della compilazione del progetto. Questa pagina si applica solo ai progetti Visual C#.

Per accedere alla pagina Compilazione, scegliere un nodo del progetto (non il nodo Soluzione) in Esplora soluzioni. Scegliere Visualizza, Pagine delle proprietà dal menu. Quando si apre Progettazione progetti, scegliere la scheda Compila.

Nota

I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio in questo articolo potrebbero essere diversi nel computer in uso. È possibile usare un'edizione diversa di Visual Studio o impostazioni di ambiente diverse. Per altre informazioni, vedere Personalizzare l'IDE.

Configurazione e Piattaforma

Le opzioni seguenti consentono di selezionare la configurazione e la piattaforma da visualizzare o modificare.

Nota

Usando configurazioni di compilazione semplificate, il sistema del progetto determina se compilare una versione di debug o una versione finale. Queste opzioni non sono di conseguenza visualizzate. Per altre informazioni, vedere Procedura: Impostare le configurazioni di debug e rilascio.

Configurazione

Specifica le impostazioni di configurazione da visualizzare o modificare. Le impostazioni possono essere Attiva (Debug) (il valore predefinito), Debug, Release o Tutte le configurazioni.

Piattaforma

Specifica le impostazioni della piattaforma da visualizzare o modificare. L'impostazione predefinita è Active (Any CPU) (Attiva (qualsiasi CPU)). È possibile modificare la piattaforma attiva tramite Gestione configurazione. Per altre informazioni, vedere How to: Create and Edit Configurations (Procedura: Creare e modificare le configurazioni).

Generali

Le opzioni seguenti consentono di configurare diverse impostazioni del compilatore C#.

Simboli di compilazione condizionale

Specifica i simboli su cui eseguire la compilazione condizionale. Separare i simboli con un punto e virgola (";"). Per altre informazioni, vedere /define (Opzioni del compilatore C#).

Definisci costante DEBUG

Definisce DEBUG come simbolo in tutti i file di codice sorgente dell'app. La selezione di questa opzione equivale all'uso dell'opzione della riga di comando /define:DEBUG.

Definisci costante TRACE

Definisce TRACE come simbolo in tutti i file di codice sorgente dell'app. La selezione di questa opzione equivale all'uso dell'opzione della riga di comando /define:TRACE.

Piattaforma di destinazione

Specifica il processore da impostare come destinazione del file di output. Scegliere x86 per qualsiasi processore compatibile con Intel a 32 bit, scegliere x64 per qualsiasi processore compatibile con Intel a 64 bit, scegliere ARM per processori ARM oppure scegliere Any CPU (Qualsiasi CPU) per specificare che qualsiasi processore è accettabile. Any CPU (Qualsiasi CPU) è il valore predefinito per i progetti, in quanto consente all'applicazione di essere eseguita su una vasta gamma di hardware.

Per altre informazioni, vedere /platform (Opzioni del compilatore C#).

Ammette i valori Null

Specifica il contesto C# nullable a livello di progetto. Questa opzione dell'interfaccia utente è stata introdotta in Visual Studio 16.5 ed è abilitata solo per i progetti che usano C# 8.0 o versione successiva.

Per altre informazioni, vedere Contesti nullable.

Preferisci 32 bit

Se la casella di controllo Preferisci 32 bit è selezionata, l'applicazione viene eseguita come applicazione a 32 bit sia nelle versioni di Windows a 32 bit sia in quelle a 64 bit. Se la casella di controllo non è selezionata, l'applicazione viene eseguita come applicazione a 32 bit nelle versioni di Windows a 32 bit e come applicazione a 64 bit nelle versioni a 64 bit di Windows.

Se un'applicazione viene eseguita come applicazione a 64 bit, le dimensioni del puntatore raddoppiano e si possono verificare problemi di compatibilità con altre librerie che sono esclusivamente a 32 bit. È utile eseguire un'applicazione a 64 bit solo se sono necessari più di 4 GB di memoria o se le istruzioni a 64 bit garantiscono un miglioramento significativo delle prestazioni.

Questa casella di controllo è disponibile solo se tutte le condizioni seguenti sono true:

  • Nella pagina Compilazione l'elenco Piattaforma di destinazione è impostato su Any CPU (Qualsiasi CPU).

  • Nella pagina Applicazione l'elenco Tipo di Output specifica che il progetto è un'applicazione.

  • Nella pagina Applicazione l'elenco Framework di destinazione specifica .NET Framework 4.5.

Consenti codice unsafe

Consente la compilazione del codice che usa la parola chiave unsafe. Per altre informazioni, vedere /unsafe (Opzioni del compilatore C#).

Ottimizza codice

Abilita o disabilita le ottimizzazioni eseguite dal compilatore per ridurre le dimensioni del file di output e aumentarne la velocità e l'efficienza. Per altre informazioni, vedere /optimize (Opzioni del compilatore C#).

Errori e avvisi

Le impostazioni riportate di seguito sono usate per configurare le opzioni di errori e avvisi del processo di compilazione.

Livello avvisi

Specifica il livello da visualizzare per gli avvisi del compilatore. Per altre informazioni, vedere /warn (Opzioni del compilatore C#).

Non visualizzare avvisi

Blocca la capacità del compilatore di generare uno o più avvisi. Separare più numeri di avvisi tramite virgola o punto e virgola. Per altre informazioni, vedere /nowarn (Opzioni del compilatore C#).

Considera gli avvisi come errori

Le impostazioni riportate di seguito sono usate per specificare quali avvisi considerare come errori. Selezionare una delle opzioni seguenti per indicare in quali condizioni restituire un errore se la compilazione rileva un avviso. Per altre informazioni, vedere /warnaserror (Opzioni del compilatore C#).

Nessuno: non considera gli avvisi come errori.

All : considera tutti gli avvisi come errori.

Avvisi specifici: considera gli avvisi specificati come errori. Separare più numeri di avvisi tramite virgola o punto e virgola.

Suggerimento

Se non si vuole che gli avvisi di analisi del codice vengano considerati come errori, vedere Domande frequenti su Analisi del codice.

Output

Le impostazioni riportate di seguito sono usate per configurare le opzioni di output del processo di compilazione.

Percorso di output

Specifica il percorso dei file di output per la configurazione del progetto. Immettere il percorso dell'output di compilazione in questa casella, oppure scegliere il pulsante Sfoglia per specificare un percorso. Il percorso è relativo. Se si immette un percorso assoluto, verrà salvato come relativo. Il percorso predefinito è bin\Debug o bin\Release\.

Usando configurazioni di compilazione semplificate, il sistema del progetto determina se compilare una versione di debug o una versione finale. Scegliendo il comando Compila dal menu Debug (F5) la compilazione verrà inserita nel percorso di debug indipendentemente dal Percorso output specificato. Il comando Compila del menu Compila la inserisce invece nel percorso specificato. Per altre informazioni, vedere Informazioni sulle configurazioni della build.

File di documentazione XML

Specifica il nome di un file in cui saranno elaborati i commenti relativi alla documentazione. Per altre informazioni, vedere /doc (Opzioni del compilatore C#).

Registra per interoperabilità COM

Indica che l'applicazione gestita esporrà un oggetto COM (COM Callable Wrapper) che consentirà a un oggetto COM di interagire con l'applicazione gestita. La proprietà Tipo di output nella pagina Applicazione di Creazione progetti dell'applicazione deve essere impostata su Libreria di classi per rendere disponibile la proprietà Registra per interoperabilità COM. Per una classe di esempio che è possibile includere nell'applicazione Visual C# ed esporre come oggetto COM, vedere Classe COM di esempio.

Genera assembly di serializzazione

Specifica se il compilatore userà lo strumento per la generazione di serializzatori XML (Sgen.exe) per creare assembly di serializzazione XML. Gli assembly di serializzazione possono migliorare le prestazioni di avvio della classe XmlSerializer, se è stata usata per serializzare i tipi nel codice. Per impostazione predefinita, questa opzione è impostata su Auto. Specifica quindi che saranno generati assembly di serializzazione solo se è stata usata la classe XmlSerializer per codificare i tipi nel codice in XML. Off specifica che non saranno mai generati assembly di serializzazione, indipendentemente dal fatto che il codice usi o meno la classe XmlSerializer. On specifica che saranno sempre generati assembly di serializzazione. Gli assembly di serializzazione sono denominati TypeName.XmlSerializers.dll. Per altre informazioni, vedere Strumento per la generazione di serializzatori XML (Sgen.exe).

Avanzato

Selezionare il collegamento per informazioni sulla finestra di dialogo Impostazioni di compilazione avanzate (C#).

Vedi anche