Compartir a través de


Propiedades reservadas de MSBuild

MSBuild proporciona un conjunto de propiedades reservadas que almacenan información sobre el archivo de proyecto y los binarios de MSBuild.Estas propiedades se evalúan de la misma manera que otras propiedades de MSBuild.Por ejemplo, para utilizar la propiedad MSBuildProjectFile escribiría:

$(MSBuildProjectFile)

Propiedades reservadas

En la tabla siguiente se describen las propiedades reservadas de MSBuild.

Propiedad

Descripción

MSBuildBinPath

La ruta de acceso absoluta de la carpeta donde se encuentran los archivos binarios de MSBuild que se está usando actualmente (por ejemplo, C: \Windows\Microsoft.Net\Framework \versionNumber\).Esta propiedad es útil si necesita hacer referencia a los archivos del directorio de MSBuild.

MSBuildExtensionsPath

Ruta de MSBuild subcarpeta bajo la carpeta \Program Files\ o \Program Files (x86)\, dependiendo del valor de bits de la ventana actual.Por ejemplo, para de 32 bits ventana en 64 bits equipo, ruta punto a la carpeta \Program Files (x86)\.Para una ventana 64 bits en un equipo de 64 bits, los puntos de la ruta de acceso a la carpeta \Program Files\.Vea también MSBuildExtensionsPath32 y MSBuildExtensionsPath64.

Esta ubicación es un lugar útil para colocar archivos de destino personalizados.Por ejemplo, los archivos de destino se pueden instalar en \Program Files\MSBuild\MyFiles\Northwind.targets y después importar en archivos de proyecto mediante este código XML:

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

NotaNota
Puede establecer la variable de entorno MSBUILDLEGACYEXTENSIONSPATH a un valor NULL para habilitar el comportamiento de MSBuildExtensionsPath en versiones anteriores.

MSBuildExtensionsPath32

Ruta de MSBuild subcarpeta bajo la carpeta \Program Files\ o \Program Files (x86)\.Este ruta siempre punto a la carpeta \Program Files\ de 32 bits en un equipo de 32 bits y a \Program Files (x86)\ en un equipo de 64 bits.Vea también MSBuildExtensionsPath y MSBuildExtensionsPath64.

MSBuildExtensionsPath64

La ruta de la subcarpeta de MSBuild en la carpeta \Program Files \.Para un equipo de 64 bits, puntos de esta ruta siempre a la carpeta \Program Files\.Para un equipo de 32 bits, esta ruta de acceso está en blanco.Vea también MSBuildExtensionsPath y MSBuildExtensionsPath32.

MSBuildLastTaskResult

true si la tarea anterior completa sin ningún error (incluso si había advertencias), o false si la tarea anterior tiene errores.

NotaNota
Normalmente, cuando se produce un error en una tarea, el error es la última acción que ocurre en ese proyecto.Por consiguiente, el valor de esta propiedad no es false, excepto en estos escenarios:

MSBuildNodeCount

El número máximo de procesos simultáneos se usan al compilar.Éste es el valor especificado para /maxcpucount en la línea de comandos.Si especificó /maxcpucount sin especificar un valor, después MSBuildNodeCount especifica el número de procesadores del equipo.Para obtener más información, vea Referencia de la línea de comandos de MSBuild y Compilar varios proyectos en paralelo con MSBuild.

MSBuildProgramFiles32

La ubicación de la carpeta de programas de 32 bits; por ejemplo, C:\Program Files (x86).

MSBuildProjectDefaultTargets

La lista completa de destinos especificados en el atributo DefaultTargets del elemento Project.Por ejemplo, el siguiente elemento de Project tendría un valor de propiedad de MSBuildDefaultTargets de A;B;C:

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

MSBuildProjectDirectory

La ruta de acceso absoluta del directorio donde se encuentra el archivo de proyecto; por ejemplo, C: \MyCompany\MyProduct \.

MSBuildProjectDirectoryNoRoot

El valor de la propiedad de MSBuildProjectDirectory, excepto la unidad raíz.

MSBuildProjectExtension

La extensión de nombre del archivo de proyecto, incluidos el punto; por ejemplo, .proj.

MSBuildProjectFile

El nombre de archivo completo del proyecto, incluida la extensión de nombre de archivo; por ejemplo, MyApp.proj.

MSBuildProjectFullPath

La ruta de acceso absoluta y nombre de archivo completo del proyecto, incluida la extensión de nombre de archivo; por ejemplo, C: \MyCompany\MyProduct\MyApp .proj.

MSBuildProjectName

El nombre del archivo de proyecto sin la extensión de nombre de archivo; por ejemplo, MyApp.

MSBuildStartupDirectory

La ruta de acceso absoluta de la carpeta donde se denomina MSBuild.Mediante esta propiedad, puede compilarlo todo debajo de un punto concreto en un árbol de proyecto sin crear archivos de dirs.proj en cada directorio.En su lugar, tiene simplemente uno proyecto- para el 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

MSBuildThisFile

La parte del nombre de archivo y la extensión de archivo MSBuildThisFileFullPath.

MSBuildThisFileDirectory

La parte del directorio de MSBuildThisFileFullPath.

MSBuildThisFileDirectoryNoRoot

La parte del directorio de MSBuildThisFileFullPath, excepto la unidad raíz.

MSBuildThisFileExtension

La parte de la extensión de nombre de archivo MSBuildThisFileFullPath.

MSBuildThisFileFullPath

La ruta de acceso absoluta del proyecto o archivo de destinos que contiene el destino que se está ejecutando.

SugerenciaSugerencia
La propiedad de MSBuildThisFileFullPath habilita la especificación de una ruta de acceso relativa de un archivo de destinos relativa al archivo de destinos y no en relación con el archivo de proyecto original.

MSBuildThisFileName

La parte del nombre de archivo de MSBuildThisFileFullPath, sin la extensión de nombre de archivo.

MSBuildToolsPath

La ruta de instalación de la versión de MSBuild asociada al valor de MSBuildToolsVersion.

MSBuildToolsVersion

La versión de MSBuild Conjunto que se utiliza para compilar el proyecto.

NotaNota
MSBuild Conjunto consta de las tareas, los destinos, y herramientas que se utilizan para compilar una aplicación.Las herramientas incluye 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.

Vea también

Conceptos

Propiedades de MSBuild

Otros recursos

Referencia de MSBuild