Propiedades reservadas y conocidas de MSBuild

MSBuild proporciona un conjunto de propiedades predefinidas que almacenan información sobre el archivo de proyecto y los archivos binarios de MSBuild. Estas propiedades se evalúan igual que otras propiedades de MSBuild. Por ejemplo, para utilizar la propiedad MSBuildProjectFile escribiría $(MSBuildProjectFile).

MSBuild utiliza los valores de la tabla siguiente para predefinir propiedades reservadas y conocidas. Las propiedades reservadas no se pueden reemplazar, y la mayoría de las propiedades conocidas no se deben reemplazar, excepto en escenarios avanzados.

Propiedades reservadas y conocidas

En la tabla de esta sección se muestran las propiedades predefinidas de MSBuild. La columna de ejemplo de la tabla se relaciona con el siguiente archivo de proyecto de ejemplo (se supone que se encuentra en C:\Source\Repos\ConsoleApp1\ConsoleApp1) y muestra un ejemplo de los valores que tienen estas propiedades cuando se accede a ellas en el archivo de proyecto, cuando MSBuild se invoca sin opciones de línea de comandos especiales.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>
</Project>

Propiedad.	Reservadas o conocidas	Descripción	Ejemplo
FrameworkSDKRoot	Conocida	Ruta de acceso a la carpeta raíz de las herramientas de .NET Framework.	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\
InnerBuildProperty	Conocida	Especifica el nombre de propiedad que define la dimensión de compilación de múltiples destinos (aplicable solo si la compilación actual es una compilación de grafo).	TargetFramework
InnerBuildPropertyValues	Conocida	Especifica el nombre de propiedad que contiene los valores posibles para InnerBuildProperty (aplicable solo si la compilación actual es una compilación de grafo).	TargetFrameworks
IsGraphBuild	Conocida	True si se trata de una compilación de grafo; es decir, la opción -graphBuild está en vigor. Esta opción significa que MSBuild construye y compila un grafo de proyecto. La construcción de un gráfico implica la identificación de las referencias de proyecto para formar las dependencias. La compilación del gráfico implica el intento de compilar referencias de proyecto antes que los proyectos que hacen referencia a ellas, lo que supone una diferencia con respecto a la programación tradicional de MSBuild.
MSBuildAssemblyVersion	Reservado	La versión de los ensamblados de MSBuild que se usan para compilar el proyecto.	17.0
MSBuildBinPath	Reservada	Ruta de acceso absoluta de la carpeta donde se encuentran los archivos binarios de MSBuild que se están usando (por ejemplo, C:\Windows\Microsoft.Net\Framework\<versionNumber>). Esta propiedad es útil si necesita hacer referencia a los archivos del directorio de MSBuild. No incluya la barra diagonal inversa final en esta propiedad.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildDisableFeaturesFromVersion	Reservada	Se usa en MSBuild y los SDK de Microsoft para administrar las oleadas de cambios.
MSBuildExtensionsPath	Conocida	Introducida en .NET Framework 4: no hay ninguna diferencia entre los valores predeterminados de MSBuildExtensionsPath y de MSBuildExtensionsPath32. Puede establecer la variable de entorno MSBUILDLEGACYEXTENSIONSPATH en un valor distinto de null para habilitar el comportamiento del valor predeterminado de MSBuildExtensionsPath en versiones anteriores. En .NET Framework 3.5 y versiones anteriores, el valor predeterminado de MSBuildExtensionsPath apunta a la ruta de la subcarpeta de MSBuild en la carpeta \Archivos de programa o \Archivos de programa (x86), según el valor de bits del proceso actual. Por ejemplo, para un proceso de 32 bits en un equipo de 64 bits, esta propiedad apunta a la carpeta \Archivos de programa (x86) . Para un proceso de 64 bits en un equipo de 64 bits, esta propiedad apunta a la carpeta \Archivos de programa. No incluya la barra diagonal inversa final en esta propiedad. Esta ubicación es un lugar útil para colocar archivos de destino personalizados. Por ejemplo, podría instalar los archivos de destino en \Archivos de programa\MSBuild\MyFiles\Northwind.targets y luego importarlos en archivos de proyecto con este código XML: <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath32	Conocida	Ruta de acceso de la subcarpeta MSBuild en la carpeta \Archivos de programa o \Archivos de programa (x86) . La ruta de acceso siempre apunta a la carpeta de 32 bits \Archivos de programa (x86) en un equipo de 32 bits y a \Archivos de programa en un equipo de 64 bits. Vea también MSBuildExtensionsPath y MSBuildExtensionsPath64. No incluya la barra diagonal inversa final en esta propiedad.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath64	Conocida	Ruta de acceso de la subcarpeta MSBuild en la carpeta \Archivos de programa. En un equipo de 64 bits, esta ruta de acceso apunta siempre a la carpeta \Archivos de programa. Para un equipo de 32 bits, esta ruta de acceso está en blanco. Vea también MSBuildExtensionsPath y MSBuildExtensionsPath32. No incluya la barra diagonal inversa final en esta propiedad.	C:\Program Files\MSBuild
MSBuildFileVersion	Reservada	La versión de cuatro partes de los ensamblados de MSBuild que se usan para compilar el proyecto.	17.4.0.46505
MSBuildFrameworkToolsPath	Conocida	Ruta de acceso a las herramientas de .NET Framework con las que se creó el MSBuild en ejecución actualmente, con una barra diagonal final.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath32	Conocida	Ruta de acceso a la versión de 32 bits de las herramientas de .NET Framework para la misma versión de Framework con la que se creó el MSBuild actualmente en ejecución, con una barra diagonal final.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath64	Conocida	Ruta de acceso a la versión de 64 bits de las herramientas de .NET Framework para la misma versión de Framework con la que se creó el MSBuild actualmente en ejecución, con una barra diagonal final.	C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\
MSBuildInteractive	Reservada	true si MSBuild se ejecuta de forma interactiva y permite entrada de usuario. Este valor se controla mediante la opción de línea de comandos -interactive.	false
MSBuildLastTaskResult	Reservada	true si la tarea anterior se completó sin errores (aunque hubiera advertencias) o false si la tarea anterior tuvo errores. Normalmente, cuando se produce un error en una tarea, el error es lo último que ocurre en ese proyecto. Por consiguiente, el valor de esta propiedad nunca es false, excepto en estos escenarios: - Cuando el atributo ContinueOnError del Elemento de tarea (MSBuild) está establecido en WarnAndContinue (o true) o ErrorAndContinue. - Cuando Target tiene un Elemento OnError (MSBuild) como elemento secundario.	true
MSBuildNodeCount	Reservada	Número máximo de procesos simultáneos que se usan al compilar. Este es el valor que ha especificado para -maxcpucount en la línea de comandos. Si ha especificado -maxcpucount sin especificar un valor, MSBuildNodeCount especifica el número de procesadores del equipo. Para obtener más información, vea Referencia de la línea de comandos y Compilar varios proyectos en paralelo.	1
MSBuildOverrideTasksPath	Conocida	Ubicación que se va a buscar para los archivos .overridetasks, que se pueden usar para proporcionar versiones personalizadas de tareas estándar. Consulte Tareas de MSBuild. No incluya la barra diagonal inversa final de la ruta.
MSBuildProgramFiles32	Reservada	Ubicación de la carpeta de programas de 32 bits; por ejemplo, C:\Archivos de programa (x86) . No incluya la barra diagonal inversa final en esta propiedad.	C:\Program Files (x86)
MSBuildProjectDefaultTargets	Reservada	Lista completa de destinos especificados en el atributo DefaultTargets del elemento Project. Por ejemplo, el siguiente elemento Project tendría un valor de propiedad MSBuildDefaultTargets de A;B;C: <Project DefaultTargets="A;B;C" >	Build
MSBuildProjectDirectory	Reservada	Ruta de acceso absoluta del directorio en el que se encuentra el archivo de proyecto, por ejemplo, C:\MyCompany\MyProduct. No incluya la barra diagonal inversa final en esta propiedad.	C:\Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectDirectoryNoRoot	Reservada	Valor de la propiedad MSBuildProjectDirectory, sin incluir la unidad raíz. No incluya la barra diagonal inversa final en esta propiedad.	Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectExtension	Reservada	Extensión de nombre de archivo del archivo de proyecto, incluido el punto; por ejemplo, .proj.	.csproj
MSBuildProjectFile	Reservada	Nombre de archivo completo del archivo de proyecto, incluida la extensión de nombre de archivo; por ejemplo, MyApp.proj.	ConsoleApp1.csproj
MSBuildProjectFullPath	Reservada	Ruta de acceso absoluta y nombre de archivo completo del archivo de proyecto, incluida la extensión de nombre de archivo; por ejemplo, C:\MyCompany\MyProduct\MyApp.proj.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildProjectName	Reservada	Nombre de archivo del archivo de proyecto sin la extensión de nombre de archivo; por ejemplo, MyApp.	ConsoleApp1
MSBuildRuntimeType	Reservada	El tipo del runtime que se está ejecutando actualmente. Se presentó en MSBuild 15. El valor puede no estar definido (antes de MSBuild 15): Full indica que MSBuild se está ejecutando en la versión de escritorio de .NET Framework, Core indica que MSBuild se está ejecutando en .NET Core (por ejemplo, en dotnet build) o Mono indica que MSBuild se está ejecutando en Mono.	Full
MSBuildStartupDirectory	Reservada	Ruta de acceso absoluta de la carpeta donde se llama a MSBuild. Con esta propiedad puede compilar todo lo que hay debajo de un punto específico de un árbol de proyecto sin crear archivos <dirs>.proj en cada directorio. En su lugar, tiene solo un proyecto, por ejemplo, c:\traversal.proj, como se muestra aquí: <Project ...> <ItemGroup> <ProjectFiles Include="$ (MSBuildStartupDirectory) **\*.csproj"/> </ItemGroup> <Target Name="build"> <MSBuild Projects="@(ProjectFiles)"/> </Target> </Project> Para compilar en cualquier punto del árbol, escriba: msbuild c:\traversal.proj No incluya la barra diagonal inversa final en esta propiedad.	c:\Source\Repos\ConsoleApp1
MSBuildThisFile	Reservada	Parte de nombre de archivo y extensión de archivo de MSBuildThisFileFullPath.	ConsoleApp1.csproj
MSBuildThisFileDirectory	Reservada	Parte de directorio de MSBuildThisFileFullPath. Incluya la barra diagonal inversa final de la ruta.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileDirectoryNoRoot	Reservada	Parte del directorio de MSBuildThisFileFullPath, sin incluir la unidad raíz. Incluya la barra diagonal inversa final de la ruta.	Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileExtension	Reservada	Parte de la extensión de nombre de archivo de MSBuildThisFileFullPath.	.csproj
MSBuildThisFileFullPath	Reservada	Ruta de acceso absoluta del archivo de proyecto o de destinos que contiene el destino que se está ejecutando. Sugerencia: Puede especificar una ruta de acceso relativa en un archivo de destinos relativa al archivo de destinos y no relativa al archivo de proyecto original.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildThisFileName	Reservada	Parte de nombre de archivo de MSBuildThisFileFullPath, sin la extensión de nombre de archivo.	ConsoleApp1
MSBuildToolsPath	Reservada	Ruta de acceso de instalación de la versión de MSBuild que se asocia al valor de MSBuildToolsVersion. No incluya la barra diagonal inversa final de la ruta. Esta propiedad no se puede invalidar.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsPath32	Conocida	Ruta de acceso de instalación de la versión de MSBuild de 32 bits que se asocia al valor de MSBuildToolsVersion. No incluya la barra diagonal inversa final de la ruta. Esta propiedad no se puede invalidar.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin
MSBuildToolsPath64	Conocida	Ruta de acceso de instalación de la versión de MSBuild de 64 bits que se asocia al valor de MSBuildToolsVersion. No incluya la barra diagonal inversa final de la ruta. Esta propiedad no se puede invalidar.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsVersion	Reservada	Versión del conjunto de herramientas de MSBuild que se utilizará para compilar el proyecto. Nota: Un conjunto de herramientas de MSBuild consta de tareas, destinos y herramientas que se utilizan para compilar una aplicación. Las herramientas incluyen compiladores como csc.exe y vbc.exe. Para obtener más información, vea Conjunto de herramientas de MSBuild (ToolsVersion) y Configuraciones de conjuntos de herramientas estándar y personalizados.	Current
MSBuildSDKsPath	Conocida	Ruta de acceso que MSBuild usa para buscar SDK.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Sdks
MSBuildSemanticVersion	Reservado	La versión de semver 2.0 completa de los ensamblados de MSBuild que se usan para compilar el proyecto.	17.4.0-preview-22465-05+6033e4c95
MSBuildUserExtensionsPath	Conocida	Esta ruta de acceso proporciona la ubicación de la carpeta de instalación de MSBuild. Se puede restablecer para proporcionar personalizaciones locales por usuario. Personalización de la compilación local No incluya la barra diagonal inversa final de la ruta.
MSBuildVersion	Reservada	La versión de MSBuild que se usa para compilar el proyecto. Esta propiedad no se puede invalidar, de lo contrario, se devuelve el mensaje de error MSB4004 - The 'MSBuildVersion' property is reserved, and can't be modified..	17.4.0
MSBuildWarningsAsErrors	Conocida	Lista de los códigos de advertencia para tratar como errores.	MSB1234;MSB5678
MSBuildWarningsAsMessages	Conocida	Lista de códigos de advertencia que se tratan como mensajes.	MSB1234;MSB5678
MSBuildWarningsNotAsErrors	Conocida	Lista de códigos de advertencia que no se deben promover a errores, incluso si el modificador -warnAsError está establecido para promover todas las demás advertencias a errores. Tenga en cuenta que no tiene ningún efecto si no es true.	MSB1234;MSB5678
OS	Conocida	En Windows, esto se hereda del sistema operativo host. Entre los valores posibles se incluyen "Windows_NT" y "Unix"; se puede establecer en valores diferentes en sistemas operativos distintos de Windows.
RoslynTargetsPath	Conocida	Ruta de acceso a destinos para compiladores de Roslyn.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\Roslyn
SDK35ToolsPath	Conocida	Ruta de acceso a las herramientas de .NET Framework 3.5.
SDK40ToolsPath	Conocida	Ruta de acceso a las herramientas de .NET Framework 4.0.	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\
VsInstallRoot	Conocida	Carpeta de instalación de Visual Studio.	C:\Program Files\Microsoft Visual Studio\2022
WindowsSDK80Path	Conocida	Ruta de acceso al SDK de Windows 8.

Propiedades específicas de proyectos de C++

Las siguientes propiedades representan la ruta de acceso a los archivos de importación de MSBuild de C++, como los archivos .props y .targets, para varias versiones del conjunto de herramientas de C++ y los sistemas operativos de destino. Los archivos de estas carpetas representan la infraestructura de compilación de C++ y son esenciales para compilar cualquier proyecto de C++ con MSBuild.

Propiedad.	Reservadas o conocidas	Descripción	Ejemplo
AndroidTargetsPath	Conocida	Ruta de acceso a archivos de importación de MSBuild de C++ para compilaciones de Android.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\MDD\Android\V150\
iOSTargetsPath	Conocida	Ruta de acceso a archivos de importación de MSBuild de C++ para compilaciones de iOS.	C:\Program Files\Microsoft Visual Studio\2022\Preview\MSBuild\Microsoft\MDD\iOS\V150\
VCTargetsPath	Conocida	Ruta de acceso a los archivos de MSBuild de C++ que admiten el sistema de compilación de C++.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\VC\v170\
VCTargetsPath10	Conocida	Ruta de acceso a los archivos de MSBuild de C++ que admiten el conjunto de herramientas de Visual Studio 2010.	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\
VCTargetsPath11	Conocida	Ruta de acceso a los archivos de importación de MSBuild para el conjunto de herramientas de Visual Studio 2012 (V110).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\
VCTargetsPath12	Conocida	Ruta de acceso a los archivos de importación de MSBuild para el conjunto de herramientas de Visual Studio 2013 (V120).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\
VCTargetsPath14	Conocida	Ruta de acceso a los archivos de importación de MSBuild para el conjunto de herramientas de Visual Studio 2015 (V140).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\

Nombres en conflicto con elementos de MSBuild

Aparte de lo anterior, los nombres relativos a elementos del lenguaje MSBuild no se pueden usar en las propiedades, elementos o metadatos de elementos definidos por el usuario:

• VisualStudioProject
• Destino
• PropertyGroup
• Salida
• ItemGroup
• UsingTask
• ProjectExtensions
• OnError
• ImportGroup
• Elegir
• Cuando
• Otherwise

Vea también

• Referencia de MSBuild

• Propiedades de MSBuild