Proprietà di progetto MSBuild comuni

Aggiornamento: novembre 2007

Tutti i progetti Visual Studio, indipendentemente dal tipo, presentano determinate proprietà MSBuild in comune e altre proprietà vengono utilizzate spesso. Di seguito è riportato un elenco delle proprietà comuni e delle proprietà utilizzate spesso.

Elenco delle proprietà e dei parametri comuni

Nome della proprietà o del parametro

Descrizione

AdditionalLibPaths

Specifica le cartelle aggiuntive nelle quali i compilatori cercano gli assembly di riferimento.

AddModules

Permette al compilatore di rendere disponibili per il progetto in compilazione tutte le informazioni sui tipi presenti nei file specificati. Questa proprietà è equivalente all'opzione del compilatore /addModules.

ALToolPath

Il percorso dove si trova AL.exe. Questa proprietà esegue l'override della versione corrente di AL.exe in modo da consentire l'utilizzo di una versione diversa.

ApplicationIcon

Il file di icona (ico) da passare al compilatore per l'incorporazione come icona Win32. La proprietà è equivalente all'opzione del compilatore /win32icon.

ApplicationManifest

Specifica il percorso del file utilizzato per generare le informazioni del manifesto esterno di Controllo dell'account utente. Questa funzionalità si applica solo ai progetti Visual Studio riguardanti Windows Vista.

Nella maggior parte dei casi, il manifesto è incorporato. Tuttavia, se si utilizza la distribuzione ClickOnce o COM senza registrazione, il manifesto può essere un file esterno installato insieme agli assembly dell'applicazione. Per ulteriori informazioni, vedere la proprietà NoWin32Manifest descritta in questo argomento.

AssemblySearchPaths

Un elenco di percorsi da utilizzare per la ricerca durante la risoluzione degli assembly di riferimento in fase di compilazione. L'ordine dei percorsi nell'elenco è significativo perché i percorsi elencati prima hanno la precedenza sulle voci successive.

AssemblyName

Il nome dell'assembly di output finale dopo la compilazione del progetto.

BaseAddress

Specifica l'indirizzo di base dell'assembly di output principale. Questa proprietà è equivalente all'opzione del compilatore /baseaddress.

BaseOutputPath

Specifica il percorso di base del file di output. Se impostata, MSBuild utilizzerà OutputPath = $(BaseOutputPath)\$(Configuration)\. Esempio di sintassi: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>

BaseIntermediateOutputPath

Specifica il percorso intermedio di base del file di output. Esempio di sintassi: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>

BuildInParallel

Un valore booleano che indica se i riferimenti al progetto sono compilati o puliti in parallelo quando si utilizza MSBuild multiprocessore. Il valore predefinito è true, in base al quale i progetti saranno compilati in parallelo se il sistema ha più nuclei o processori.

BuildProjectReferences

Un valore booleano che indica se i riferimenti al progetto sono compilati da MSBuild. Impostare false se si sta compilando il progetto nell'ambiente di sviluppo integrato (IDE) Visual Studio, altrimenti impostare true.

BaseIntermediateOutputPath

La cartella di primo livello dove vengono create tutte le cartelle di output intermedie specifiche della configurazione. Il valore predefinito è obj\.

CleanFile

Il nome del file che viene utilizzato come "cache pulita". "Cache pulita" è l'elenco dei file generati da eliminare durante l'operazione di pulizia. Il file è inserito nel percorso di output intermedio dal processo di compilazione.

Questa proprietà specifica solo nomi file privi delle informazioni sul percorso.

CodePage

Consente di specificare la tabella codici da utilizzare per tutti i file di codice sorgente inclusi nella compilazione. Questa proprietà è equivalente all'opzione del compilatore /codepage.

CompilerResponseFile

Un file di risposta facoltativo che può essere passato alle attività del compilatore.

Configurazione

La configurazione che si sta compilando, "debug" o "rilascio".

CscToolPath

Il percorso di csc.exe, il compilatore Visual C#.

CustomBeforeMicrosoftCommonTargets

Il nome di un file di progetto o file targets che deve essere importato automaticamente prima dell'importazione delle destinazioni comuni.

DebugSymbols

Un valore booleano che indica se i simboli sono generati dalla compilazione.

/p:DebugSymbols=false sulla riga di comando disattiva la generazione dei file di simboli (pdb) del database di programma.

DefineConstants

Definisce le costanti di compilazione condizionale. Le coppie simbolo/valore sono separate da punti e virgola e vengono specificate utilizzando la seguente sintassi:

simbolo1 = valore1; simbolo2 = valore2

La proprietà è equivalente all'opzione del compilatore /define.

DefineDebug

Un valore booleano che indica se la costante DEBUG deve essere definita.

DefineTrace

Un valore booleano che indica se la costante TRACE deve essere definita.

DebugType

Definisce il livello di informazioni di debug da generare. I valori validi sono "full", "pdbonly" e "none".

DelaySign

Un valore booleano che indica se per l'assembly si desidera la firma ritardata anziché quella completa.

DisabledWarnings

Evita la visualizzazione degli avvisi specificati. È necessario specificare solo la parte numerica dell'identificatore dell'avviso. Se sono specificati più avvisi, questi sono separati da punti e virgola. Questo parametro corrisponde all'opzione /nowarn del compilatore vbc.exe.

DisableFastUpToDateCheck

Un valore booleano che si applica solo a Visual Studio. Il gestore di compilazione Visual Studio utilizza il processo FastUpToDateCheck per determinare se un progetto deve essere ricompilato per essere aggiornato. Questo processo esegue la determinazione più velocemente rispetto a MSBuild. L'impostazione della proprietà DisableFastUpToDateCheck su true consente di ignorare il gestore di compilazione Visual Studio forzandola a utilizzare MSBuild per determinare se il progetto è aggiornato.

DocumentationFile

Il nome del file generato come file di documentazione XML. Include solo il nome file senza informazioni sul percorso.

ErrorReport

Specifica la modalità di segnalazione degli errori interni del compilatore. I valori validi sono "prompt", "send" o "none". Questa proprietà è equivalente all'opzione del compilatore /errorreport.

ExcludeDeploymentUrl

L'Attività GenerateDeploymentManifest aggiunge un tag deploymentProvider al manifesto di distribuzione se il file di progetto contiene uno degli elementi seguenti:

  • UpdateUrl

  • InstallUrl

  • PublishUrl

Se si utilizza ExcludeDeploymentUrl, tuttavia, è possibile impedire che il tag deploymentProvider venga aggiunto al manifesto di distribuzione anche se si specifica uno degli URL appena elencati. A tale scopo, aggiungere nel file di progetto la proprietà seguente:

<ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>

Nota

ExcludeDeploymentUrl non viene esposto nell'IDE di Visual Studio è può essere impostato solo tramite la modifica manuale del file di progetto. L'impostazione di questa proprietà non influisce sulla pubblicazione in Visual Studio. In altre parole, il tag deploymentProvider verrà comunque aggiunto all'URL specificato da PublishUrl.

FileAlignment

Specifica, in byte, il punto in cui allineare le sezioni del file di output. I valori validi sono 512, 1024, 2048, 4096, 8192. Questa proprietà è equivalente all'opzione del compilatore /filealignment.

FrameworkPathOverride

Specifica la posizione dei file mscorlib.dll e microsoft.visualbasic.dll. Questo parametro è equivalente all'opzione /sdkpath del compilatore vbc.exe.

GenerateDocumentation

Un parametro booleano che indica se la documentazione è generata dalla compilazione. Se il parametro è impostato su true, le informazioni relative alla documentazione vengono generate dalla compilazione e inserite in un file xml con il nome dell'eseguibile o della libreria creata dalla compilazione.

IntermediateOutputPath

Il percorso di output intermedio completo derivato da BaseIntermediateOutputPath, se non è specificato alcun percorso. Ad esempio, \obj\debug\. Se viene eseguito l'override di questa proprietà, l'impostazione BaseIntermediateOutputPath non ha effetto.

KeyContainerName

Il nome del contenitore di chiavi con nome sicuro.

KeyOriginatorFile

Il nome del file di chiave con nome sicuro.

NoWin32Manifest

Determina se il compilatore genera il manifesto Win32 predefinito nell'assembly di output. Il valore predefinito false indica che il manifesto Win32 predefinito viene generato per tutte le applicazioni. Questa proprietà è equivalente all'opzione /nowin32manifest del compilatore vbc.exe.

ModuleAssemblyName

Il nome dell'assembly nel quale il modulo compilato deve essere incorporato. La proprietà è equivalente all'opzione del compilatore /moduleassemblyname.

NoLogo

Un valore booleano che indica se si desidera che il logo del compilatore sia disattivato. Questa proprietà è equivalente all'opzione del compilatore /nologo.

NoStdLib

Un valore booleano che indica se evitare il riferimento alla libreria standard (mscorlib.dll). Il valore predefinito è false.

NoVBRuntimeReference

Un valore booleano che indica se il runtime Visual Basic (Microsoft.VisualBasic.dll) deve essere incluso come riferimento nel progetto.

NoWin32Manifest

Valore booleano che indica se le informazioni sul manifesto del controllo dell'account utente verranno incorporate nel file eseguibile dell'applicazione. Questa funzionalità si applica solo ai progetti Visual Studio riguardanti Windows Vista. Nei progetti distribuiti tramite ClickOnce e mediante componenti COM senza registrazione, questo elemento viene ignorato. False (valore predefinito) indica che le informazioni sul manifesto del controllo dell'account utente verranno incorporate nel file eseguibile dell'applicazione. True indica che tali informazioni non verranno incorporate.

Questa proprietà si applica solo ai progetti Visual Studio riguardanti Windows Vista. Nei progetti distribuiti tramite ClickOnce e mediante componenti COM senza registrazione, questa proprietà viene ignorata.

La proprietà NoWin32Manifest deve essere aggiunta solo se si desidera che Visual Studio non incorpori informazioni sul manifesto nel file eseguibile dell'applicazione. Questo processo è definito virtualizzazione. Per utilizzare la virtualizzazione, impostare <ApplicationManifest> insieme a <NoWin32Manifest> nel modo seguente:

  • Nei progetti Visual Basic, rimuovere il nodo <ApplicationManifest>. Nei progetti Visual Basic, infatti, <NoWin32Manifest> viene ignorato quando esiste un nodo <ApplicationManifest>.

  • Nei progetti Visual C#, impostare <ApplicationManifest> su False e <NoWin32Manifest> su True. Nei progetti Visual C#, infatti, <ApplicationManifest> esegue l'override di <NoWin32Manifest>.

Optimize

Un valore booleano che se impostato su true attiva le ottimizzazioni del compilatore. Questa proprietà è equivalente all'opzione del compilatore /optimize.

OptionCompare

Specifica la modalità con cui vengono confrontate le stringhe. I valori validi sono "binary" o "text". Questa proprietà è equivalente all'opzione /optioncompare del compilatore vbc.exe.

OptionExplicit

Un valore booleano che se impostato su true richiede la dichiarazione esplicita delle variabili nel codice sorgente. Questa proprietà è equivalente all'opzione del compilatore /optionexplicit.

OptionInfer

Un valore booleano che se impostato su true attiva l'inferenza dei tipi delle variabili. Questa proprietà è equivalente all'opzione del compilatore /optioninfer.

OptionStrict

Un valore booleano che se impostato su true fa sì che l'attività di compilazione applichi la semantica del tipo ridotta per limitare le conversioni implicite di tipi. Questa proprietà è equivalente all'opzione /optionstrict del compilatore vbc.exe.

OutputPath

Questa proprietà è di norma specificata nel file di progetto ed è simile a OutDir. OutputPath è obsoleto e allorché possibile è preferibile utilizzare invece OutDir.

OutputType

Specifica il formato del file di output. Per il parametro è possibile specificare uno dei valori riportati di seguito.

  • Library. Consente la creazione di una libreria di codici. Valore predefinito.

  • Exe. Crea un'applicazione console.

  • Modulo. Crea un modulo.

  • Winexe. Crea un programma per Windows.

Questa proprietà è equivalente all'opzione /target del compilatore vbc.exe.

OverwriteReadOnlyFiles

Un valore booleano che indica se si desidera consentire alla compilazione di sovrascrivere i file di sola lettura o restituire un errore.

PdbFile

Il nome del file pdb che si sta generando. Questa proprietà è equivalente all'opzione /pdb del compilatore csc.exe.

Platform

Il sistema operativo per cui si sta effettuando la compilazione. I valori validi sono "AnyCPU", "x86", "x64" o "Itanium".

RemoveIntegerChecks

Un valore che indica se deve essere disattivato il controllo degli errori di overflow dei valori integer. Il valore predefinito è false. Questa proprietà è equivalente all'opzione /removeintchecks del compilatore vbc.exe.

SGenUseProxyTypes

Un valore booleano che indica se i tipi proxy devono essere generati da SGen.exe.

SGenToolPath

Un percorso dello strumento facoltativo che indica dove trovare SGen.exe quando viene eseguito l'override della versione corrente di SGen.exe.

StartupObject

Specifica la classe o il modulo che contiene il metodo Main o la procedura Sub Main. Questa proprietà è equivalente all'opzione del compilatore /main.

ProcessorArchitecture

L'architettura del processore utilizzata quando vengono risolti i riferimenti all'assembly. I valori validi sono "msil", "x86", "amd64", o "ia64".

RootNamespace

Lo spazio dei nomi radice da utilizzare quando si denomina una risorsa incorporata. Questo spazio dei nomi fa parte del nome del manifesto di risorsa incorporata.

Satellite_AlgorithmId

L'ID dell'algoritmo di hash di AL.exe da utilizzare quando vengono creati gli assembly satellite.

Satellite_BaseAddress

L'indirizzo di base da utilizzare quando gli assembly satellite specifici delle impostazioni cultura vengono compilati utilizzando la destinazione CreateSatelliteAssemblies.

Satellite_CompanyName

Il nome dell'azienda da passare ad AL.exe durante la generazione degli assembly satellite.

Satellite_Configuration

Il nome della configurazione da passare ad AL.exe durante la generazione degli assembly satellite.

Satellite_Description

Il testo di descrizione da passare ad AL.exe durante la generazione degli assembly satellite.

Satellite_EvidenceFile

Incorpora il file specificato nell'assembly satellite con il nome di risorsa "Security.Evidence".

Satellite_FileVersion

Specifica una stringa per il campo Versione file nell'assembly satellite.

Satellite_Flags

Specifica un valore per il campo Flag dell'assembly satellite.

Satellite_GenerateFullPaths

Determina l'utilizzo del percorso assoluto durante la compilazione per tutti i file segnalati in un messaggio di errore.

Satellite_LinkResource

Collega i file di risorse specificati a un assembly satellite.

Satellite_MainEntryPoint

Specifica il nome completo, ovvero class.method, del metodo da utilizzare come un punto di ingresso quando un modulo è convertito in un file eseguibile durante la generazione dell'assembly satellite.

Satellite_ProductName

Specifica una stringa per il campo Prodotto dell'assembly satellite.

Satellite_ProductVersion

Specifica una stringa per il campo Versione prodotto nell'assembly satellite.

Satellite_TargetType

Specifica il formato del file di output dell'assembly satellite come "library", "exe" o "win". Il valore predefinito è "library".

Satellite_Title

Specifica una stringa per il campo Titolo dell'assembly satellite.

Satellite_Trademark

Specifica una stringa per il campo Marchio dell'assembly satellite.

Satellite_Version

Specifica le informazioni sulla versione dell'assembly satellite.

Satellite_Win32Icon

Inserisce un file di icona (ico) nell'assembly satellite.

Satellite_Win32Resource

Inserisce una risorsa Win32 (file res) nell'assembly satellite.

TargetCompactFramework

La versione di .NET Compact Framework richiesta per eseguire l'applicazione in compilazione. Consente di fare riferimento a certi assembly del framework a cui non è possibile fare riferimento diversamente.

TargetFrameworkVersion

Versione di .NET Framework richiesta per eseguire l'applicazione in compilazione. Consente di fare riferimento a certi assembly del framework a cui non è possibile fare riferimento diversamente.

TreatWarningsAsErrors

Un parametro booleano che, se impostato su true, fa sì che tutti gli avvisi vengano trattati come errori. Questo parametro è equivalente all'opzione del compilatore /nowarn.

UseHostCompilerIfAvailable

Un parametro booleano che, se impostato su true, fa sì che l'attività di compilazione utilizzi l'oggetto del compilatore in-process, se disponibile. Questo parametro è utilizzato solo da Visual Studio.

Utf8Output

Un parametro booleano che, se impostato su true, registra l'output del compilatore utilizzando la codifica UTF-8. Questo parametro è equivalente all'opzione del compilatore /utf8Output.

VbcToolPath

Un percorso facoltativo che indica un altro percorso per vbc.exe quando viene eseguito l'override della versione corrente di vbc.exe.

VbcVerbosity

Specifica il livello di dettaglio dell'output del compilatore Visual Basic. I valori validi sono "Quiet", "Normal" (predefinito) o "Verbose".

WarningsAsErrors

Specifica un elenco di avvisi da considerare come errori. Questo parametro è equivalente all'opzione del compilatore /warnaserror.

WarningsNotAsErrors

Specifica un elenco di avvisi da non considerare come errori. Questo parametro è equivalente all'opzione del compilatore /warnaserror.

Win32Manifest

Il nome del file manifesto che deve essere incorporato nell'assembly finale. Questo parametro è equivalente all'opzione del compilatore /win32Manifest.

Wint32Resource

Il nome file della risorsa Win32 da incorporare nell'assembly finale. Questo parametro è equivalente all'opzione del compilatore /win32resource.

Vedere anche

Riferimenti

Elementi di progetto MSBuild comuni