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.Queste proprietà vengono valutate analogamente ad 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.
Proprietà |
Descrizione |
|---|---|
MSBuildBinPath |
Il percorso assoluto della cartella in cui i binari di MSBuild che stanno utilizzare vengono individuati, ad esempio C:\Windows\Microsoft.Net\Framework\versionNumber\).Tale proprietà risulta utile quando è necessario fare riferimento ai file nella directory MSBuild. |
MSBuildExtensionsPath |
Percorso di MSBuild sottocartella in \ programmi \ o \ programmi (x86) \, a seconda del numero di bit della finestra corrente.Ad esempio, per 32 bit finestra in computer a 64 bit, percorso punto in \ programmi (x86) \.Per una finestra a 64 bit su un computer a 64 bit, i punti del percorso \ programmi \.Vedere anche MSBuildExtensionsPath32 e MSBuildExtensionsPath64. Questa posizione è utile per la memorizzazione dei file di destinazione personalizzati.Ad esempio, i file di destinazione potrebbero essere installati in \ programmi \ MSBuild \ MyFiles \ Northwind.targets quindi essere inclusi nei file di progetto utilizzando questo codice XML: <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/> .gif "Nota") Nota
È possibile impostare la variabile di ambiente MSBUILDLEGACYEXTENSIONSPATH su un valore non Null per abilitare il comportamento di MSBuildExtensionsPath nelle versioni precedenti.
|
MSBuildExtensionsPath32 |
Percorso di MSBuild sottocartella in \ programmi \ o \ programmi (x86) \.Questo percorso sempre punto a 32 bit \ programmi \ a 32 bit del computer e \ programmi (x86) \ su un computer a 64 bit.Vedere anche MSBuildExtensionsPath e MSBuildExtensionsPath64. |
MSBuildExtensionsPath64 |
Il percorso della sottocartella di MSBuild in \ programmi \.Per un computer a 64 bit, punti di questo percorso sempre \ programmi \.Per un computer a 32 bit, questo percorso è vuoto.Vedere anche MSBuildExtensionsPath e MSBuildExtensionsPath32. |
MSBuildLastTaskResult |
true se l'attività precedente è stata completata senza errori (anche se sono state avvisi), o false se l'attività precedente era errori. Nota
In genere, quando si verifica un errore in un'attività, l'errore è l'ultimo elemento che si verifica in tale progetto.Di conseguenza, il valore di questa proprietà non è mai false, tranne che negli scenari seguenti:
|
MSBuildNodeCount |
Il numero massimo di processi simultanei utilizzati durante la compilazione.Questo è il valore specificato per /maxcpucount la riga di comando.Se è stato specificato /maxcpucount senza specificare un valore, quindi MSBuildNodeCount specifica il numero di processori nel computer.Per ulteriori informazioni, vedere Riferimenti alla riga di comando di MSBuild e Compilazione di più progetti in parallelo con MSBuild. |
MSBuildProgramFiles32 |
Il percorso della cartella del programma a 32 bit, ad esempio, C:\Program Files (x86). |
MSBuildProjectDefaultTargets |
L'elenco completo delle destinazioni specificate con l'attributo DefaultTargets dell'elemento Project.Ad esempio, l'elemento di Project comporterebbe un valore della proprietà di MSBuildDefaultTargets di A;B;C: <Project DefaultTargets="A;B;C" > |
MSBuildProjectDirectory |
Il percorso assoluto della directory contenente il file di progetto è disponibile; ad esempio, C:\MyCompany\MyProduct\. |
MSBuildProjectDirectoryNoRoot |
Il valore della proprietà di MSBuildProjectDirectory, escludendo l'unità radice. |
MSBuildProjectExtension |
L'estensione del file di progetto, inclusi il punto, ad esempio, proj. |
MSBuildProjectFile |
Il nome file completo del file di progetto, inclusa l'estensione di file, ad esempio, MyApp.proj. |
MSBuildProjectFullPath |
Il percorso assoluto e il nome file completo del file di progetto, inclusa l'estensione di file, ad esempio, C:\MyCompany\MyProduct\MyApp.proj. |
MSBuildProjectName |
Il nome del file di progetto senza l'estensione di file, ad esempio, MyApp. |
MSBuildStartupDirectory |
Il percorso assoluto della cartella in cui MSBuild viene chiamato.Tramite questa proprietà, è possibile compilare tutto in un punto specifico in una struttura ad albero del progetto senza creare i file di dirs.proj per ogni directory.Invece, è un unico progetto, ad esempio c:\traversal.proj, come illustrato di seguito: Per compilare in un punto qualsiasi della struttura ad albero, digitare: |
MSBuildThisFile |
La parte di estensione di file e di nome file di MSBuildThisFileFullPath. |
MSBuildThisFileDirectory |
La parte della directory di MSBuildThisFileFullPath. |
MSBuildThisFileDirectoryNoRoot |
La parte della directory di MSBuildThisFileFullPath, escludendo l'unità radice. |
MSBuildThisFileExtension |
La parte di estensione di file di MSBuildThisFileFullPath. |
MSBuildThisFileFullPath |
Il percorso assoluto del progetto o il file targets contenente il database di destinazione in esecuzione. Suggerimento
La proprietà di MSBuildThisFileFullPath abilita la specifica di un percorso relativo in un file targets relativo al file targets e non al file di progetto originale.
|
MSBuildThisFileName |
La parte del nome file di MSBuildThisFileFullPath, senza estensione. |
MSBuildToolsPath |
Il percorso di installazione della versione di MSBuild associata al valore di MSBuildToolsVersion. |
MSBuildToolsVersion |
La versione del set di strumenti di MSBuild utilizzati per compilare il progetto. Nota
Il set di strumenti di MSBuild sono costituite da attività di, destinazioni di e strumenti utilizzati per compilare un'applicazione.Gli strumenti include compilatori come csc.exe e vbc.exe.Per ulteriori informazioni, vedere Set di strumenti di MSBuild (ToolsVersion) e Configurazioni standard e personalizzate del set di strumenti.
|