Compartilhar via

Propriedades reservadas e conhecidas do MSBuild

  • Artigo

MSBuild fornece um conjunto de propriedades predefinidas que armazenam informações sobre o arquivo de projeto e os binários MSBuild. Essas propriedades são avaliadas da mesma maneira que outras propriedades MSBuild. Por exemplo, para usar a propriedade MSBuildProjectFile, digite $(MSBuildProjectFile).

O MSBuild usa os valores na tabela a seguir para predefinir propriedades conhecidas e reservadas. As propriedades reservadas não podem ser substituídas, mas as propriedades conhecidas podem ser substituídas usando propriedades de ambiente com o mesmo nome, propriedades globais ou propriedades que são declaradas no arquivo de projeto.

Propriedades reservadas e conhecidas

A tabela a seguir descreve as propriedades predefinidas MSBuild.

Propriedade

Descrição

Reservadas ou conhecidas

MSBuildBinPath

O caminho absoluto da pasta em que os binários MSBuild que estão sendo usados no momento estão localizados (por exemplo, C:\Windows\Microsoft.Net\Framework\versionNumber). Essa propriedade será útil se você precisar fazer referência a arquivos no diretório MSBuild.

Não inclua a barra invertida final nessa propriedade.

Reservado

MSBuildExtensionsPath

Apresentado no .NET Framework 4: não há diferença entre os valores padrão de MSBuildExtensionsPath e MSBuildExtensionsPath32. Você pode definir a variável de ambiente MSBUILDLEGACYEXTENSIONSPATH como um valor não nulo para habilitar o comportamento do valor padrão de MSBuildExtensionsPath em versões anteriores.

No .NET Framework 3.5 e versões anteriores, o valor padrão de MSBuildExtensionsPath aponta para o caminho da subpasta MSBuild na pasta \Program Files\ ou \Program Files (x86), dependendo do número de bits do processo atual. Por exemplo, para um processo de 32 bits em um computador de 64 bits, essa propriedade aponta para a pasta \Program Files (x86). Para um processo de 64 bits em um computador de 64 bits, essa propriedade aponta para a pasta \Program Files.

Não inclua a barra invertida final nessa propriedade.

Esse local é um local útil para colocar os arquivos de destino personalizados. Por exemplo, os arquivos de destino poderiam ser instalados em \Program Files\MSBuild\MyFiles\Northwind.targets e importados em arquivos de projeto usando esse código XML:

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

Conhecidas

MSBuildExtensionsPath32

O caminho da subpasta MSBuild na pasta \Program Files ou \Program Files (x86). Esse caminho sempre aponta para a pasta de 32 bits \Program Files em um computador de 32 bits e \Program Files (x86) em um computador de 64 bits. Consulte também MSBuildExtensionsPath e MSBuildExtensionsPath64.

Não inclua a barra invertida final nessa propriedade.

Conhecidas

MSBuildExtensionsPath64

O caminho da subpasta MSBuild na pasta \Program Files. Para uma máquina de 64 bits, esse caminho sempre aponta para a pasta \Program Files. Para uma máquina de 32 bits, esse caminho fica em branco. Consulte também MSBuildExtensionsPath e MSBuildExtensionsPath32.

Não inclua a barra invertida final nessa propriedade.

Conhecidas

MSBuildLastTaskResult

true se a tarefa anterior foi concluída sem erros (mesmo se houver avisos) ou false se a tarefa anterior tiver erros. Normalmente, quando ocorre um erro em uma tarefa, o erro é a última coisa que ocorre nesse projeto. Portanto, o valor dessa propriedade nunca é false, exceto nestes cenários:

Reservado

MSBuildNodeCount

O número máximo de processos simultâneos que são usados durante a compilação. Esse é o valor especificado para /maxcpucount na linha de comando. Se você especificou /maxcpucount sem especificar um valor, então MSBuildNodeCount especifica o número de processadores no computador. Para obter mais informações, consulte Referência de linha de comando MSBuild e Criando vários projetos paralelamente com o MSBuild.

Reservado

MSBuildProgramFiles32

O local da pasta do programa de 32 bits; por exemplo, C:\Program Files (x86).

Não inclua a barra invertida final nessa propriedade.

Reservado

MSBuildProjectDefaultTargets

A lista completa de destinos que estão especificados no atributo DefaultTargets do elemento Project. Por exemplo, o seguinte elemento Project teria um valor da propriedade MSBuildDefaultTargets de A;B;C:

<Project DefaultTargets="A;B;C" >

Reservado

MSBuildProjectDirectory

O caminho absoluto do diretório em que o arquivo de projeto está localizado, por exemplo C:\MyCompany\MyProduct.

Não inclua a barra invertida final nessa propriedade.

Reservado

MSBuildProjectDirectoryNoRoot

O valor da propriedade MSBuildProjectDirectory, excluindo a unidade raiz.

Não inclua a barra invertida final nessa propriedade.

Reservado

MSBuildProjectExtension

A extensão de nome de arquivo do arquivo de projeto, incluindo o período; por exemplo,. proj.

Reservado

MSBuildProjectFile

O nome de arquivo completo do arquivo de projeto, incluindo a extensão de nome de arquivo; por exemplo, MyApp.proj.

Reservado

MSBuildProjectFullPath

O caminho absoluto e o nome de arquivo completo do arquivo de projeto, incluindo a extensão de nome de arquivo; por exemplo, C:\MyCompany\MyProduct\MyApp.proj.

Reservado

MSBuildProjectName

O nome de arquivo do arquivo de projeto sem a extensão de nome de arquivo; por exemplo, MyApp.

Reservado

MSBuildStartupDirectory

O caminho absoluto da pasta em que MSBuild é chamado. Usando essa propriedade, você pode compilar tudo abaixo de um ponto específico em uma árvore de projeto sem criar arquivos dirs.proj em cada diretório. Em vez disso, você tem apenas um projeto — por exemplo, c:\traversal.proj, como mostrado aqui:

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

Para compilar em qualquer ponto da árvore, digite:

msbuild c:\traversal.proj

Não inclua a barra invertida final nessa propriedade.

Reservado

MSBuildThisFile

O nome do arquivo e a parte da extensão do arquivo de MSBuildThisFileFullPath.

Reservado

MSBuildThisFileDirectory

A parte do diretório de MSBuildThisFileFullPath.

Inclua a barra invertida final no caminho.

Reservado

MSBuildThisFileDirectoryNoRoot

A parte do diretório de MSBuildThisFileFullPath, excluindo a unidade raiz.

Inclua a barra invertida final no caminho.

Reservado

MSBuildThisFileExtension

A parte da extensão do nome de arquivo de MSBuildThisFileFullPath.

Reservado

MSBuildThisFileFullPath

O caminho absoluto do projeto ou do arquivo de destinos que contém o destino que está sendo executado.

Dica

Você pode especificar um caminho relativo em um arquivo de destinos que é relativo ao arquivo de destinos e não relativo ao arquivo de projeto original.

Reservado

MSBuildThisFileName

A parte do nome de arquivo de MSBuildThisFileFullPath, sem a extensão de nome de arquivo.

Reservado

MSBuildToolsPath

O caminho de instalação da versão MSBuild associada ao valor de MSBuildToolsVersion.

Não inclua a barra invertida final no caminho.

Essa propriedade não pode ser substituída.

Reservado

MSBuildToolsVersion

A versão do Conjunto de ferramentas MSBuild que é usado para compilar o projeto.

Dica

Um Conjunto de ferramentas MSBuild consiste em tarefas, destinos e ferramentas que são usados para compilar um aplicativo.As ferramentas incluem compiladores, tais como csc.exe e vbc.exe.Para obter mais informações, consulte MSBuild Toolset (ToolsVersion) e Configurações padrão e personalizadas do Toolset.

Reservado

Consulte também

Conceitos

Propriedades do MSBuild

Outros recursos

Referência do MSBuild