Propriedades do MSBuild
As propriedades são pares chave/valor que podem ser usados para configurar compilações.Propriedades são úteis para passar valores para as tarefas, avaliação de condições, e armazenar valores que serão referenciado thoughout o arquivo de projeto.
Definindo e referenciar propriedades no arquivo de projeto
Propriedades são declaradas através da criação de um elemento com o nome da propriedade sistema autônomo um filho de um PropertyGroup elemento. Por exemplo, o XML a seguir cria uma propriedade chamada BuildDir com um valor de Build.
<PropertyGroup>
<BuildDir>Build</BuildDir>
</PropertyGroup>
Fazer referência a propriedades em todo o arquivo de projeto com a sintaxe $(PropertyName). Por exemplo, fazer referência à propriedade no exemplo anterior com $(BuildDir).
Definindo propriedades na linha de comando
MSBuild permite que você conjunto propriedades a partir da linha de comando usando comutador de linha de comando /propriedade ou /p. Valores de propriedade recebidos a partir da linha de comando substituem valores de propriedade definidos no arquivo de projeto e valores de propriedade herdadas de variáveis de ambiente.
O exemplo a seguir define o Configuration propriedade para DEBUG.
MSBuild.exe MyProj.proj /p:Configuration=DEBUG
Propriedades reservadas
MSBuild reserva alguns nomes de propriedades para armazenar informações sobre o arquivo de projeto e o MSBuild binários. Essas propriedades são referenciadas com a notação $ como qualquer Outros propriedade.Para obter mais informações, consulte Como: Referência ao nome ou local do arquivo de projeto e O MSBuild reservado propriedades.
Environment Variables
Você pode referenciar variáveis de ambiente em arquivos de projeto da mesma forma sistema autônomo propriedades reservadas.Por exemplo, para usar a variável de ambiente PATH no arquivo de projeto, use $ (caminho).Se o projeto contém uma definição de propriedade que h sistema autônomo o mesmo nome sistema autônomo uma variável de ambiente, a propriedade no projeto substitui o valor da variável de ambiente.Para obter mais informações, consulte Como: Usar variáveis de ambiente em uma compilação.
Armazenar XML em Propriedades
Propriedades podem conter XML arbitrário, que pode ajudar a passar valores para as tarefas ou exibir informações de registrar registrar registrar em log.O exemplo a seguir mostra o ConfigTemplate propriedade com um valor que contém o XML e outras referências de propriedade. MSBuild substitui as referências de propriedade com seus valores de propriedade respectivos. Valores de propriedade são interpretados de cima para baixo, isso neste exemplo, $(MySupportedVersion), $(MyRequiredVersion), e $(MySafeMode) deve já foram definidas.
<PropertyGroup>
<ConfigTemplate>
<Configuration>
<Startup>
<SupportedRuntime
ImageVersion="$(MySupportedVersion)"
Version="$(MySupportedVersion)"/>
<RequiredRuntime
ImageVersion="$(MyRequiredVersion)
Version="$(MyRequiredVersion)"
SafeMode="$(MySafeMode)"/>
</Startup>
</Configuration>
</ConfigTemplate>
</PropertyGroup>
Consulte também
Tarefas
Como: Usar variáveis de ambiente em uma compilação
Como: Referência ao nome ou local do arquivo de projeto