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"/>
Nota
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.
Nota
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í:
Para compilar en cualquier punto del árbol, escriba:
|
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.
Sugerencia
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.
Nota
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.
|