Поделиться через

Зарезервированные свойства MSBuild

  • Статья

MSBuild предоставляет набор зарезервированных свойств для сохранения информации о файле проекта и двоичных файлах MSBuild.Эти свойства оцениваются точно так же, как и другие свойства MSBuild.Например, для использования свойства MSBuildProjectFile необходимо ввести:

$(MSBuildProjectFile)

Зарезервированные свойства

В следующей таблице описаны зарезервированные свойства MSBuild.

Свойство

Описание

MSBuildBinPath

Абсолютный путь к папке, где бинарный MSBuild, которые в данный момент находятся используются (например, C:\Windows\Microsoft.Net\Framework\versionNumber\).Это свойство полезно в том случае, когда необходимо задать ссылку на файлы в каталоге MSBuild.

MSBuildExtensionsPath

Путь MSBuild вложенную папку в папке \ Program Files \ или \ Program Files (x86) \, в зависимости от разрядности текущего окна.Например, для 32 - 64 окно на 32-разрядных компьютерах, путь указывает на \ Program Files (x86) \.64 Для разрядного окна на 64 разрядном компьютере, путь указывает на \ Program Files \.См. также MSBuildExtensionsPath32 и MSBuildExtensionsPath64.

Это расположение хорошо подходит для хранения пользовательских файлов целевых объектов.Например, в качестве конечные файлов может быть задано в \ Program Files \ MyFiles MSBuild \ \ Northwind.targets и затем импортирован в файлах проекта с помощью этого кода XML:

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

ПримечаниеПримечание
Можно задать переменную среды MSBUILDLEGACYEXTENSIONSPATH в значение, отличное от NULL для включения расширения функциональности MSBuildExtensionsPath в предыдущих версиях.

MSBuildExtensionsPath32

Путь MSBuild вложенную папку в папке \ Program Files \ или \ Program Files (x86) \.Этот путь всегда указывает на 32 - \ Program Files \ на 64-разрядный компьютер 32 и \ Program Files (x86) \ 64 разрядном на компьютере.См. также MSBuildExtensionsPath и MSBuildExtensionsPath64.

MSBuildExtensionsPath64

Путь к вложенной папки MSBuild в папке \ Program Files \.64 Для разрядного компьютера, этот путь всегда указывает на \ Program Files \.На 32-разрядном компьютере этот путь является пустым.См. также MSBuildExtensionsPath и MSBuildExtensionsPath32.

MSBuildLastTaskResult

значение true, если предыдущая задача завершилась без ошибок, то (даже если были предупреждения), или значение false, если предыдущая задача имела ошибки.

ПримечаниеПримечание
Обычно при возникновении ошибки в задаче, ошибка последнее действие, которое выполняется в этом проекте.Таким образом, значение этого свойства не может иметь значение false, за исключением в следующих сценариях:

MSBuildNodeCount

Максимальное количество параллельных процессов, применяемых при создании.Это значение, заданное для /maxcpucount в командной строке.Если указан /maxcpucount без указания значения, MSBuildNodeCount указывает количество процессоров в компьютере.Дополнительные сведения см. в разделах Справочник по командной строке MSBuild и Параллельное построение нескольких проектов с помощью MSBuild.

MSBuildProgramFiles32

Расположение 32 разрядной папки программы; например, C:\Program Files (x86).

MSBuildProjectDefaultTargets

Полный список целевых объектов, указанных в атрибуте DefaultTargets элемента Project.Например, следующий элемент Project будет иметь значение свойства MSBuildDefaultTargetsA;B;C:

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

MSBuildProjectDirectory

Абсолютный путь к каталогу, где находится файл проекта; например, C:\MyCompany\MyProduct\.

MSBuildProjectDirectoryNoRoot

Значение свойства MSBuildProjectDirectory, за исключением корневого диска.

MSBuildProjectExtension

Расширение имени файла проекта, включая точку; например, PROJ.

MSBuildProjectFile

Полное имя файла проекта, включая расширение имени файла; например, MyApp.proj.

MSBuildProjectFullPath

Абсолютный путь и полное имя файла проекта, включая расширение имени файла; например, C:\MyCompany\MyProduct\MyApp.proj.

MSBuildProjectName

Имя файла проекта без расширения имени файла; например, MyApp.

MSBuildStartupDirectory

Абсолютный путь к папке, где MSBuild называется.С помощью этого свойства, можно построить все под указанным моментом в дереве проекта без создания файлов dirs.proj в любом каталоге.Вместо этого имеется только одно проект- для примера (c:\traversal.proj, как показано ниже:

<Project ...>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

Для построения в любой момент в дереве введите:

msbuild c:\traversal.proj

MSBuildThisFile

Часть имени файла и расширения файла MSBuildThisFileFullPath.

MSBuildThisFileDirectory

Часть каталога MSBuildThisFileFullPath.

MSBuildThisFileDirectoryNoRoot

Часть каталога MSBuildThisFileFullPath, за исключением корневого диска.

MSBuildThisFileExtension

Часть расширения имени файла MSBuildThisFileFullPath.

MSBuildThisFileFullPath

Абсолютный путь проекта или файла целевых объектов, содержащий целевой объект, выполняется.

СоветСовет
Свойство MSBuildThisFileFullPath содержит спецификацию относительного пути в файле целевых объектов, относительно файл целевых объектов и не относительно файл исходного проекта.

MSBuildThisFileName

Часть имени файла MSBuildThisFileFullPath без расширения имени файла.

MSBuildToolsPath

Путь установки версии MSBuild, связанную со значением MSBuildToolsVersion.

MSBuildToolsVersion

Версия набора инструментов MSBuild, который используется для построения проекта.

ПримечаниеПримечание
Набор инструментов MSBuild состоит из задач, целевых объектов и средств, используемых для построения приложения.Средства включают пакет как csc.exe и vbc.exe.Дополнительные сведения см. в разделах Набор инструментов MSBuild (ToolsVersion) и Стандартные и настраиваемые конфигурации наборов инструментов.

См. также

Основные понятия

Свойства MSBuild

Другие ресурсы

Справочные сведения о MSBuild