Metadados de item conhecidos do MSBuild
Metadados de item são valores anexados a itens. Alguns são atribuídos pelo MSBuild a itens quando os itens são criados, mas você também pode definir os metadados necessários. Alguns valores de metadados definidos pelo usuário têm significado para o MSBuild, tarefas específicas ou SDKs, como o SDK do .NET.
A tabela neste artigo descreve os metadados atribuídos a cada item após a criação. A tabela a seguir mostra alguns metadados opcionais que têm significado para o MSBuild, que você pode definir para controlar o comportamento de build. Em cada exemplo, a declaração de item a seguir foi usada para incluir o arquivo C:\MyProject\Source\Program.cs no projeto.
<ItemGroup>
<MyItem Include="Source\Program.cs" />
</ItemGroup>
| Metadados de item | Descrição |
|---|---|
| %(FullPath) | Contém o caminho completo do item. Por exemplo: C:\MyProject\Source\Program.cs |
| %(RootDir) | Contém o diretório raiz do item. Por exemplo: C:\ |
| %(Nome do arquivo) | Contém o nome do arquivo do item, sem a extensão. Por exemplo: do Programa |
| %(Extensão) | Contém a extensão de nome de arquivo do item. Por exemplo: .cs |
| %(RelativeDir) | Contém o caminho especificado no atributo Include, até a barra invertida final (\). Por exemplo:origem\ Se o atributo Include for um caminho completo, %(RelativeDir) começará com o diretório raiz %(RootDir). Por exemplo: C:\MyProject\Source\ |
| %(Diretório) | Contém o diretório do item, sem o diretório raiz. Por exemplo: MyProject\Source\ |
| %(RecursiveDir) | Se o atributo Include contiver o curinga **, esses metadados especificarão a parte do caminho que substitui o curinga. Para obter mais informações sobre curingas, consulte Como selecionar os arquivos a serem compilados.Se a pasta C:\MySolution\MyProject\Source\ contiver o arquivo Program.cse se o arquivo de projeto contiver este item: <ItemGroup><MyItem Include="C:\**\Program.cs" /></ItemGroup>em seguida, o valor de %(MyItem.RecursiveDir) seria MySolution\MyProject\Source\. |
| %(Identidade) | O item especificado no atributo Include. Por exemplo:Source\Program.cs |
| %(ModifiedTime) | Contém o carimbo de data/hora da última vez em que o item foi modificado. Por exemplo:2004-07-01 00:21:31.5073316 |
| %(CreatedTime) | Contém o carimbo de data/hora de quando o item foi criado. Por exemplo:2004-06-25 09:26:45.8237425 |
| %(AccessedTime) | Contém o carimbo de data/hora da última vez em que o item foi acessado.2004-08-14 16:52:36.3168743 |
| %(DefinindoProjectFullPath) | Contém o caminho completo do arquivo de projeto (ou arquivo importado) que define esse item. |
| %(DefinindoProjectDirectory) | Contém o diretório do projeto do arquivo de projeto (ou arquivo importado) que define esse item. |
| %(DefinindoProjectName) | Contém o nome do arquivo de projeto (ou arquivo importado) que define esse item (sem a extensão). |
| %(DefiningProjectExtension) | Contém a extensão do arquivo de projeto (ou arquivo importado) que define esse item. |