Compartir a través de

Metadatos de elementos conocidos de MSBuild

  • Artículo

Los metadatos de elemento son valores adjuntos a elementos. MsBuild asigna algunos a los elementos cuando se crean los elementos, pero también puede definir los metadatos que necesite. Algunos valores de metadatos definidos por el usuario tienen significado para MSBuild, tareas específicas o SDK, como el SDK de .NET.

En la tabla de este artículo se describen los metadatos asignados a cada elemento tras la creación. En la tabla siguiente se muestran algunos metadatos opcionales que tienen significado para MSBuild, que puede definir para controlar el comportamiento de la compilación. En cada ejemplo, se usó la siguiente declaración de elemento para incluir el archivo C:\MyProject\Source\Program.cs en el proyecto.

<ItemGroup>
    <MyItem Include="Source\Program.cs" />
</ItemGroup>
Metadatos de elementos Descripción
%(FullPath) Contiene la ruta de acceso completa del elemento. Por ejemplo:

C:\MyProject\Source\Program.cs
%(RootDir) Contiene el directorio raíz del elemento. Por ejemplo:

C:\
%(nombre de archivo) Contiene el nombre de archivo del elemento, sin la extensión . Por ejemplo:

programa
%(extensión) Contiene la extensión de nombre de archivo del elemento. Por ejemplo:

.cs
%(RelativeDir) Contiene la ruta de acceso especificada en el atributo Include, hasta la barra diagonal inversa final (\). Por ejemplo:

Source\

Si el atributo Include es una ruta de acceso completa, %(RelativeDir) comienza con el directorio raíz %(RootDir). Por ejemplo:

C:\MyProject\Source\
%(directorio) Contiene el directorio del elemento, sin el directorio raíz. Por ejemplo:

MyProject\Source\
%(RecursiveDir) Si el atributo Include contiene el carácter comodín **, estos metadatos especifican la parte de la ruta de acceso que reemplaza al carácter comodín. Para obtener más información sobre los caracteres comodín, vea Cómo: Seleccionar los archivos para compilar.

Si la carpeta C:\MySolution\MyProject\Source\ contiene el archivo Program.csy si el archivo del proyecto contiene este elemento:

<ItemGroup>

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

</ItemGroup>

a continuación, el valor de %(MyItem.RecursiveDir) sería MySolution\MyProject\Source\.
%(identidad) Elemento especificado en el atributo Include. Por ejemplo:

Source\Program.cs
%(ModifiedTime) Contiene la marca de tiempo de la última vez que se modificó el elemento. Por ejemplo:

2004-07-01 00:21:31.5073316
%(CreatedTime) Contiene la marca de tiempo de la creación del elemento. Por ejemplo:

2004-06-25 09:26:45.8237425
%(AccessedTime) Contiene la marca de tiempo de la última vez que se obtuvo acceso al elemento.

2004-08-14 16:52:36.3168743
%(DefineProjectFullPath) Contiene la ruta de acceso completa del archivo de proyecto (o archivo importado) que define este elemento.
%(DefineProjectDirectory) Contiene el directorio del proyecto del archivo de proyecto (o archivo importado) que define este elemento.
%(DefineProjectName) Contiene el nombre del archivo de proyecto (o archivo importado) que define este elemento (sin la extensión).
%(DefineProjectExtension) Contiene la extensión del archivo de proyecto (o archivo importado) que define este elemento.

Consulte también