Elemento Project (MSBuild)

  • Artículo

Elemento raíz necesario de un archivo de proyecto de MSBuild.

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         TreatAsLocalProperty="PropertyA;PropertyB"
         ToolsVersion=<version number>
         xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Choose>... </Choose>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Target>... </Target>
    <UsingTask.../>
    <ProjectExtensions>... </ProjectExtensions>
    <Import... />
</Project>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

DefaultTargets

Atributo opcional.

Los destinos predeterminados que serán el punto de entrada de la compilación si no se ha especificado ningún destino.Los destinos múltiples se delimitan mediante punto y coma (;).

Si no se especifica un destino en el atributo DefaultTargets o en la línea de comandos de MSBuild, el motor ejecuta el primer destino del archivo de proyecto después de evaluar los elementos Import.

InitialTargets

Atributo opcional.

Los destinos iniciales que se ejecutarán antes que los especificados en el atributo DefaultTargets o en la línea de comandos.Los destinos múltiples se delimitan mediante punto y coma (;).

ToolsVersion

Atributo opcional.

Versión del conjunto de herramientas que MSBuild utiliza para determinar los valores de $(MSBuildBinPath) y $(MSBuildToolsPath).

TreatAsLocalProperty

Atributo opcional.

Nombres de propiedad que no se consideran ser globales.Este atributo impide que las propiedades específicas de la línea de comandos invalidan los valores de propiedad establecidos en un archivo de proyecto o de destinos y todas las importaciones subsiguientes.Varias propiedades son punto y coma (;) delimitado.

Normalmente, las propiedades globales reemplazan los valores de propiedad establecidos en el proyecto o archivo de destinos.Si la propiedad aparece en el valor TreatAsLocalProperty , el valor de propiedad global no reemplaza los valores de propiedad establecidos en qué archivo y cualquier importación subsiguiente.Para obtener más información, vea Cómo: Compilar los mismos archivos de código fuente con diferentes opciones.

NotaNota
Las propiedades globales establecidas en un símbolo del sistema con el modificador /property (o /p).También puede establecer o modificar las propiedades globales para proyectos secundarios en un multi- proyecto compilado mediante el atributo Properties de la tarea de MSBuild.Para obtener más información, vea MSBuild (Tarea).

Xmlns

Atributo necesario.

El atributo xmlns debe tener el valor de "https://schemas.microsoft.com/developer/msbuild/2003".

Elementos secundarios

Elemento

Descripción

Choose

Elemento opcional.

Evalúa los elementos secundarios para seleccionar un conjunto de elementos ItemGroup y/o los elementos PropertyGroup que se evaluarán.

Import

Elemento opcional.

Permite a un archivo de proyecto importar otro archivo de proyecto.Puede haber cero o más elementos Import en un proyecto.

ItemGroup

Elemento opcional.

Un elemento de agrupación para elementos individuales.Elementos se especifican mediante el elemento Item.Puede haber cero o más elementos ItemGroup en un proyecto.

ProjectExtensions

Elemento opcional.

Ofrece una manera de conservar información que no pertenece a MSBuild en un archivo de proyecto de MSBuild.Puede haber cero o un elemento ProjectExtensions en un proyecto.

PropertyGroup

Elemento opcional.

Un elemento de agrupación para propiedades individuales.Las propiedades se especifican mediante el elemento Property.Puede haber cero o más elementos PropertyGroup en un proyecto.

Destino

Elemento opcional.

Contiene un conjunto de tareas que MSBuild ejecutará secuencialmente.Las tareas se especifican mediante el elemento Task.Puede haber cero o más elementos Target en un proyecto.

UsingTask

Elemento opcional.

Ofrece una manera de registrar las tareas en MSBuild.Puede haber cero o más elementos UsingTask en un proyecto.

Elementos primarios

Ninguno.

Vea también

Tareas

Cómo: Especificar qué destino utilizar primero al compilar

Referencia

Referencia de la línea de comandos de MSBuild

Conceptos

Referencia de esquemas del archivo de proyecto MSBuild

Otros recursos

MSBuild