Condividi tramite

Usare le proprietà riservate per fare riferimento al nome o al percorso del file di progetto

MSBuild fornisce proprietà riservate che fanno riferimento al nome del file di progetto e ad altre proprietà correlate al progetto. È possibile usare il nome o il percorso del progetto nel file di progetto stesso senza dover creare la propria proprietà. Per altre informazioni sulle proprietà riservate, vedere Proprietà riservate e note di MSBuild.

Prerequisiti

Progetto di Visual Studio compilato con MSBuild.

Usare le proprietà di progetto riservate

MSBuild fornisce alcune proprietà riservate che è possibile usare nei file di progetto senza definirle ogni volta. Ad esempio, la proprietà MSBuildProjectName riservata fornisce un riferimento al nome del file di progetto. La proprietà MSBuildProjectDirectory riservata fornisce un riferimento al percorso del file di progetto.

Un vantaggio dell'uso della proprietà riservata è che tutte le modifiche apportate al nome del file di progetto vengono incorporate automaticamente. Alla successiva compilazione del progetto, del file di output e di altri nomi di file che usano la proprietà vengono aggiornati automaticamente al nuovo nome.

Per usare le proprietà del progetto, fare riferimento alla proprietà nel file di progetto con la $() notazione, esattamente come qualsiasi proprietà. Per esempio:

<CSC Sources = "@(CSFile)"
    OutputAssembly = "$(MSBuildProjectName).exe"/>
</CSC>

Per informazioni sull'uso di caratteri speciali nei riferimenti a file o progetti, vedere Caratteri speciali di MSBuild.

Annotazioni

Non è possibile ridefinire le proprietà riservate nel file di progetto.

Usare MSBuildProjectName per specificare il nome del file di output

Il file di progetto di esempio seguente fa riferimento al nome del progetto come proprietà riservata per specificare il nome dell'output.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"
    DefaultTargets = "Compile">

    <!-- Specify the inputs -->
    <ItemGroup>
        <CSFile Include = "consolehwcs1.cs"/>
    </ItemGroup>
    <Target Name = "Compile">
        <!-- Run the Visual C# compilation using
        input files of type CSFile -->
        <CSC Sources = "@(CSFile)"
            OutputAssembly = "$(MSBuildProjectName).exe" >
            <!-- Set the OutputAssembly attribute of the CSC task
            to the name of the project -->
            <Output
                TaskParameter = "OutputAssembly"
                ItemName = "EXEFile" />
        </CSC>
        <!-- Log the file name of the output file -->
        <Message Text="The output file is @(EXEFile)"/>
    </Target>
</Project>

Usare MSBuildProjectDirectory per creare il percorso completo di un file

Il file di progetto di esempio seguente usa la MSBuildProjectDirectory proprietà riservata per creare il percorso completo di un file nel percorso del file di progetto. Nell'esempio viene usata la sintassi della proprietà funzione per chiamare il metodo statico System.IO.Path.Combine .NET Framework.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <!-- Build the path to a file in the root of the project -->
    <PropertyGroup>
        <NewFilePath>$([System.IO.Path]::Combine($(MSBuildProjectDirectory), `BuildInfo.txt`))</NewFilePath>
    </PropertyGroup>
</Project>

Contenuti correlati