Compartilhar via


MSBuild reservado propriedades

MSBuild fornece um conjunto de propriedades reservados que armazenam informações sobre o arquivo de projeto e os binários de MSBuild .Essas propriedades são avaliadas da mesma forma como outras propriedades de MSBuild .Por exemplo, para usar a propriedade de MSBuildProjectFile , você digita:

$(MSBuildProjectFile)

Propriedades reservados

A tabela a seguir descreve as propriedades reservadas MSBuild .

Propriedade

Descrição

MSBuildBinPath

O caminho absoluto da pasta onde os binários de MSBuild que estão sendo usados atualmente são encontrados (por exemplo, C:\Windows\Microsoft.Net\Framework\versionNumber\).Esta propriedade é útil se você precisa referenciar arquivos no diretório de MSBuild .

MSBuildExtensionsPath

Caminho de arquivo MSBuild subpasta em \ program files \ \ ou arquivo de programa (x) pasta \, dependendo do bitness da janela atual.Por exemplo, para um de 32 bits na janela de 64 bits computador, o caminho ponto no \ arquivo de programa (x) pasta \.Para uma janela de 64 bits em um computador de 64 bits, os pontos de caminho para o \ program files \ pasta.Consulte também MSBuildExtensionsPath32 e MSBuildExtensionsPath64.

Esse local é um local útil para colocar arquivos de destino personalizados.Por exemplo, os arquivos de destino podem ser instalados no \ program files \ \ \ Northwind.targets MSBuild MyFiles e então ser importados em arquivos de projeto usando esse código XML:

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

ObservaçãoObservação
Você pode definir a variável de ambiente MSBUILDLEGACYEXTENSIONSPATH a um valor não-nulo para ativar o comportamento de MSBuildExtensionsPath em versões anteriores.

MSBuildExtensionsPath32

Caminho de arquivo MSBuild subpasta em \ program files \ \ ou arquivo de programa (x) pasta \.Este caminho sempre ponto um de 32 bits do programa \ \ arquivo na pasta de 32 bits e computador \ arquivo de programa (x86 \) em um computador de 64 bits.Consulte também MSBuildExtensionsPath e MSBuildExtensionsPath64.

MSBuildExtensionsPath64

O caminho da subpasta de MSBuild em \ program files \ pasta.Para um computador de 64 bits, pontos desse caminho sempre o \ program files \ pasta.Para um computador de 32 bits, esse caminho está em branco.Consulte também MSBuildExtensionsPath e MSBuildExtensionsPath32.

MSBuildLastTaskResult

true se a tarefa anterior tiver terminado sem erros (se ocorreram avisos), ou false se a tarefa anterior teve erros.

ObservaçãoObservação
Normalmente, quando ocorre um erro em uma tarefa, o erro é a coisa mais recente que acontece no projeto.Como consequência, o valor dessa propriedade é nunca false, exceto nesses cenários:

MSBuildNodeCount

O número máximo de processos simultâneas que são usados para compilar.Este é o valor que você especificou 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.

MSBuildProgramFiles32

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

MSBuildProjectDefaultTargets

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

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

MSBuildProjectDirectory

O caminho absoluto do diretório onde o arquivo de projeto é encontrado; por exemplo, C:\MyCompany\MyProduct\.

MSBuildProjectDirectoryNoRoot

O valor da propriedade de MSBuildProjectDirectory , excluindo raiz da unidade.

MSBuildProjectExtension

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

MSBuildProjectFile

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

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.

MSBuildProjectName

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

MSBuildStartupDirectory

O caminho absoluto da pasta onde MSBuild é chamado.Usando essa propriedade, você pode compilar tudo abaixo de um ponto específico em uma árvore de projeto sem criar arquivos de dirs.proj em cada diretório.Em vez disso, você tem apenas um Project- 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 momento na árvore, digite:

msbuild c:\traversal.proj

MSBuildThisFile

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

MSBuildThisFileDirectory

A parte do diretório de MSBuildThisFileFullPath.

MSBuildThisFileDirectoryNoRoot

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

MSBuildThisFileExtension

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

MSBuildThisFileFullPath

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

DicaDica
A propriedade de MSBuildThisFileFullPath permite a especificação de um caminho relativo em um arquivo de destino relativa ao arquivo de destino e não relativo ao arquivo de projeto original.

MSBuildThisFileName

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

MSBuildToolsPath

O caminho de instalação de versão de MSBuild que está associada com o valor de MSBuildToolsVersion.

MSBuildToolsVersion

A versão do kit de ferramentas de MSBuild que é usado para criar o projeto.

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

Consulte também

Conceitos

Propriedades do MSBuild

Outros recursos

Referência do MSBuild