Proprietà riservate MSBuild
In MSBuild è disponibile un set di proprietà riservate che consentono di memorizzare le informazioni relative ai file di progetto e ai file binari di MSBuild. Tali proprietà vengono valutate analogamente alle altre proprietà di MSBuild. Ad esempio, per utilizzare la proprietà MSBuildProjectFile, è necessario digitare quanto segue:
$(MSBuildProjectFile)
Proprietà riservate
Nella tabella riportata di seguito sono descritte le proprietà riservate di MSBuild.
Property |
Oggetto di descrizione |
|---|---|
MSBuildProjectDirectory |
Il percorso assoluto della directory in cui si trova il file di progetto, ad esempio C:\MyCompany\MyProduct. |
MSBuildProjectFile |
Il nome completo del file di progetto, inclusa l'estensione, ad esempio MyApp.proj. |
MSBuildProjectExtension |
L'estensione del nome del file di progetto, incluso il punto, ad esempio .proj. |
MSBuildProjectFullPath |
Il percorso assoluto e il nome completo del file di progetto, ad esempio C:\MyCompany\MyProduct\MyApp.proj. |
MSBuildProjectName |
Il nome del file di progetto senza l'estensione, ad esempio MyApp. |
MSBuildBinPath |
Il percorso assoluto della cartella in cui si trovano i binari MSBuild attualmente in uso, ad esempio, C:\Windows\Microsoft.Net\Framework\v2.0. Tale proprietà risulta utile quando è necessario fare riferimento ai file nella directory MSBuild. |
MSBuildProjectDefaultTargets |
L'elenco completo delle destinazioni specificate con l'attributo DefaultTargets dell'elemento Project. L'elemento Project riportato di seguito avrebbe, ad esempio, una proprietà MSBuildDefaultTargets con valore A;B;C. <Project DefaultTargets="A;B;C" > |
MSBuildExtensionsPath |
La sottocartella di MSBuild inclusa nella cartella Programmi o Programmi (x86). Questo percorso punta sempre alla cartella File di programma con lo stesso numero di bit della finestra in cui il sistema è in esecuzione attualmente. Ad esempio, per una finestra a 32 bit di un computer a 64 bit, il percorso punta alla cartella dei File di programma (x86). Per una finestra a 64 bit di un computer a 64 bit, il percorso punta alla cartella dei File di programma. Vedere anche MSBuildExtensionsPath32 e MSBuildExtensionsPath64. Questa posizione è utile per la memorizzazione dei file di destinazione personalizzati. Ad esempio, è possibile installare i file di destinazione nella directory \Programmi\MSBuild\MyFiles\Northwind.targets, quindi importarli nei file di progetto utilizzando il codice XML riportato di seguito. <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/> Nota È possibile impostare la variabile di ambiente MSBUILDLEGACYEXTENSIONSPATH su un valore non null per abilitare il comportamento di MSBuildExtensionsPath nelle versioni precedenti. |
MSBuildExtensionsPath32 |
La sottocartella di MSBuild inclusa nella cartella Programmi o Programmi (x86). Questo percorso punta sempre alla cartella File di programma a 32 bit. Ad esempio, in un computer a 32 bit, il percorso punta alla cartella File di programma. Per un computer a 64 bit, il percorso punta alla cartella dei File di programma (x86). Vedere anche MSBuildExtensionsPath e MSBuildExtensionsPath64. |
MSBuildExtensionsPath64 |
La sottocartella MSBuild inclusa nella cartella \Programmi\. Questo percorso punta sempre alla cartella File di programma a 64 bit. in un computer a 64 bit. Per un computer a 32 bit, questo percorso è vuoto. Vedere anche MSBuildExtensionsPath e MSBuildExtensionsPath32. |
MSBuildStartupDirectory |
Il percorso assoluto della cartella in cui è richiamato MSBuild. Ciò consente di passare a qualsiasi punto di una struttura ad albero del progetto e compilare tutto ciò che si trova al di sotto di quel punto senza la necessità di creare file di tipo "dirs.proj" in ogni directory. È invece disponibile un solo progetto, come illustrato nell'esempio denominato c:\traversal.proj: Per la compilazione in qualsiasi punto della struttura ad albero si potrebbe digitare: |