Proprietà riservate di MSBuild

  • Articolo

Aggiornamento: novembre 2007

In MSBuild è disponibile un insieme 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. Per utilizzare ad esempio la proprietà MSBuildProjectFile, è necessario digitare quanto segue:

$(MSBuildProjectFile)

Proprietà riservate

Nella tabella riportata di seguito sono descritte le proprietà riservate di MSBuild.

Proprietà

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 directory in cui si trovano i binari MSBuild attualmente in uso, ad esempio, C:\Windows\Microsoft.Net\Framework\v2.0. Tale proprietà è utile se è 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 cartella di MSBuild inclusa nella cartella Programmi. 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 e quindi importarli nei file di progetto utilizzando il codice XML riportato di seguito.

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

MSBuildStartupDirectory

Il percorso assoluto della directory 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 dovere creare file di tipo "dirs.proj" in ogni directory. È invece disponibile un solo progetto, chiamato in questo esempio c:\traversal.proj:

<Project …>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

Quindi, in qualsiasi punto dell'albero si potrebbe digitare:

msbuild c:\traversal.proj

Vedere anche

Concetti

Proprietà di MSBuild

Altre risorse

Riferimenti a MSBuild