MSBuild 常见项的元数据

更新:2007 年 11 月

下表描述创建每一项时分配给该项的元数据。在每一个示例中,都使用了下面的项声明将 C:\MyProject\Source\Program.cs 文件包含在项目中。

<ItemGroup>
    <MyItem Include="Source\Program.cs" />
</ItemGroup>

项的元数据

说明

%(FullPath)

包含项的完整路径。例如:

C:\MyProject\Source\Program.cs

%(RootDir)

包含项的根目录。例如:

C:\

%(Filename)

包含项的文件名,但不包含扩展名。例如:

Program

%(Extension)

包含项的文件扩展名。例如:

.cs

%(RelativeDir)

包含 Include 属性中指定的路径,直到最后的反斜杠 (\)。例如:

Source\

%(Directory)

包含项的目录,但不包含根目录。例如:

MyProject\Source\

%(RecursiveDir)

如果 Include 属性包含通配符 **,该元数据将指定文件路径,从通配符的位置开始。有关通配符的更多信息,请参见如何:使用通配符生成目录中的所有文件

此示例中没有 RecursiveDir 元数据,但是如果使用下面的示例包含此项,则此项将包含 MyProject\Source\ 的 RecursiveDir 值。

<ItemGroup>

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

</ItemGroup>

如果使用下面的示例包含此项,则此项的 RecursiveDir 值将仍然是 MyProject\Source\。

<ItemGroup>

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

</ItemGroup>

%(Identity)

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

请参见

概念

MSBuild 项

MSBuild 批处理

其他资源

MSBuild 参考