Referência de esquema de arquivos de projeto do MSBuild

Fornece uma tabela de todos os elementos do esquema XML do MSBuild com os respectivos elementos filho e atributos disponíveis.

O MSBuild usa arquivos de projeto para instruir o mecanismo de build sobre o que e como compilar. Os arquivos de projeto do MSBuild são arquivos XML que seguem o esquema XML do MSBuild. Esta seção documenta o arquivo de definição de esquema XML (.xsd) para o MSBuild.

Arquivos de definição do esquema XSD do MSBuild

O link de esquema em um arquivo de projeto do MSBuild não é exigido no Visual Studio 2017 e posterior. Se estiver presente, ele deverá ser http://schemas.microsoft.com/developer/msbuild/2003, independentemente da versão do Visual Studio. Esse valor não é um destino da Web ativo; o arquivo de definição de esquema do MSBuild mais atual (arquivo .xsd) pode ser encontrado em Microsoft.Build.xsd.

A tabela a seguir mostra os links para cada versão do esquema XSD:

Versão do MSBuild Link do GitHub Link bruto (para ferramentas)
17,7 Microsoft.Build.xsd versão 17.7.0 raw
17.6 Microsoft.Build.xsd versão 17.6.3 raw
17.5 Microsoft.Build.xsd versão 17.5.1 raw
17.4 Microsoft.Build.xsd versão 17.4.4 raw
17.3 Microsoft.Build.xsd versão 17.3.1 raw
17.2 Microsoft.Build.xsd versão 17.2.1 raw
17.1 Microsoft.Build.xsd versão 17.1.1 raw
17.0 Microsoft.Build.xsd versão 17.0.0 raw
16.11 Microsoft.Build.xsd versão 16.11.2 raw
16,10 Microsoft.Build.xsd versão 16.10.2 raw
16,9 Microsoft.Build.xsd versão 16.9.2 raw
16.8 Microsoft.Build.xsd versão 16.8.3 raw
16.7 Microsoft.Build.xsd versão 16.7.0.37604 raw
16.4 Microsoft.Build.xsd versão 16.4.0.56107 raw
15.9 Microsoft.Build.xsd versão 15.9.21.664 raw

O arquivo XSD de nível superior inclui dois outros arquivos XSD filhos, Microsoft.Build.CommonTypes.xsd e Microsoft.Build.Core.xsd. Você também pode encontrar todos os arquivos de definição do esquema de XSD do MSBuild na pasta de instalação do Visual Studio em Xml\Schemas\1033\MSBuild.

Para saber mais sobre as versões do MSBuild, incluindo uma tabela das versões correspondentes do SDK do .NET, consulte Visão geral do .NET, MSBuild e controle de versão do Visual Studio.

Elementos do esquema XML do MSBuild

A tabela a seguir lista todos os elementos MSBuild de esquema XML junto com os respectivos atributos e elementos filho.

Elemento Elementos filho Atributos
Elemento Choose (MSBuild) Otherwise

Quando
--
Elemento Import (MSBuild) -- Condição

Project
Elemento ImportGroup Importar Condição
Elemento Item (MSBuild) ItemMetaData Condição

Excluir

Incluir

Remover
Elemento ItemDefinitionGroup (MSBuild) Item Condição
Elemento ItemGroup (MSBuild) Item Condição
Elemento ItemMetadata (MSBuild) Item Condição
Elemento OnError (MSBuild) -- Condição

ExecuteTargets
Elemento Otherwise (MSBuild) Choose

ItemGroup

PropertyGroup
--
Elemento Output (MSBuild) -- Condição

ItemName

PropertyName

TaskParameter
Elemento Parameter -- Saída

ParameterType

Obrigatório
Elemento ParameterGroup Parâmetro --
Elemento Project (MSBuild) Choose

Importar

ItemGroup

ProjectExtensions

PropertyGroup

Destino

UsingTask
DefaultTargets

InitialTargets

Sdk

ToolsVersion

TreatAsLocalProperty

xmlns
Elemento ProjectExtensions (MSBuild) -- --
Elemento Property (MSBuild) -- Condição
Elemento PropertyGroup (MSBuild) Propriedade Condição
Elemento Sdk (MSBuild) -- Nome

Versão
Elemento Target (MSBuild) OnError

Tarefa
AfterTargets

BeforeTargets

Condição

DependsOnTargets

Entradas

KeepDuplicateOutputs

Nome

outputs

Retornos
Elemento Task de Target (MSBuild) Saída Condição

ContinueOnError

Parâmetro
Elemento Task de UsingTask (MSBuild) Dados Avaliar
Elemento UsingTask (MSBuild) ParameterGroup

Tarefa
AssemblyFile

AssemblyName

Condição

TaskFactory

TaskName
Elemento When (MSBuild) Choose

ItemGroup

PropertyGroup
Condição

Confira também