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

Метаданные известных элементов MSBuild

  • Статья

Метаданные элементов — это значения, присоединенные к элементам. Некоторые из них назначаются MSBuild элементам при создании элементов, но также можно определить необходимые метаданные. Некоторые пользовательские значения метаданных имеют значение ДЛЯ MSBuild, определенных задач или пакетов SDK, таких как пакет SDK для .NET.

В таблице этой статьи описываются метаданные, назначенные каждому элементу при создании. В следующей таблице показаны некоторые необязательные метаданные, имеющие значение для MSBuild, которые можно определить для управления поведением сборки. В каждом примере для включения файла C:\MyProject\Source\Program.cs проекта использовалось следующее объявление элемента.

<ItemGroup>
    <MyItem Include="Source\Program.cs" />
</ItemGroup>
Метаданные элементов Описание
%(FullPath) Содержит полный путь к элементу. Например:

C:\MyProject\Source\Program.cs
%(RootDir) Содержит корневой каталог элемента. Например:

C:\
%(имя файла) Содержит имя файла элемента без расширения. Например:

программы
%(расширение) Содержит расширение имени файла элемента. Например:

.cs
%(RelativeDir) Содержит путь, указанный в атрибуте Include, вплоть до конечной обратной косой черты (\). Например:

Source\

Если атрибут Include является полным путем, %(RelativeDir) начинается с корневого каталога %(RootDir). Например:

C:\MyProject\Source\
%(каталог) Содержит каталог элемента без корневого каталога. Например:

MyProject\Source\
%(RecursiveDir) Если атрибут Include содержит подстановочный знак **, этот метаданный указывает часть пути, заменяющего подстановочный знак. Дополнительные сведения о подстановочных знаках см. в разделе Практическое руководство. Выбор файлов для сборки.

Если папка C:\MySolution\MyProject\Source\ содержит файл Program.cs, а файл проекта содержит этот элемент:

<ItemGroup>

<MyItem Include="C:\**\Program.cs" />

</ItemGroup>

затем значение %(MyItem.RecursiveDir) будет MySolution\MyProject\Source\.
%(удостоверение) Элемент, указанный в атрибуте Include. Например:

Source\Program.cs
%(ModifiedTime) Содержит метку времени с момента последнего изменения элемента. Например:

2004-07-01 00:21:31.5073316
%(CreatedTime) Содержит метку времени при создании элемента. Например:

2004-06-25 09:26:45.8237425
%(AccessedTime) Содержит метку времени с момента последнего доступа к элементу.

2004-08-14 16:52:36.3168743
%(DefiningProjectFullPath) Содержит полный путь к файлу проекта (или импортированному файлу), который определяет этот элемент.
%(DefiningProjectDirectory) Содержит каталог проекта файла проекта (или импортированного файла), который определяет этот элемент.
%(DefiningProjectName) Содержит имя файла проекта (или импортированного файла), определяющего этот элемент (без расширения).
%(DefiningProjectExtension) Содержит расширение файла проекта (или импортированного файла), определяющего этот элемент.

См. также