Bekannte MSBuild-ElementmetadatenMSBuild well-known item metadata

Elementmetadaten sind an Elemente angefügte Werte.Item metadata are values attached to items. Einige werden den Elementen von MSBuild zugewiesen, wenn die Elemente erstellt werden, aber Sie können auch jegliche benötigten Metadaten selbst definieren.Some are assigned by MSBuild to items when items are create, but you can also define any metadata you need. Einige benutzerdefinierte Metadatenwerte haben eine Bedeutung in MSBuild, in bestimmten Aufgaben oder in SDKs wie z. B. dem .NET SDK.Some user-defined metadata values have meaning to MSBuild, specific tasks tasks, or SDKs such as the .NET SDK.

In der ersten Tabelle in diesem Artikel werden die jedem Element bei der Erstellung zugewiesenen Metadaten beschrieben.The first table in this article describes the metadata assigned to every item upon creation. Die nächste Tabelle zeigt einige optionale Metadaten, die eine Bedeutung in MSBuild haben und die Sie zum Steuern des Buildverhaltens definieren können.The next table shows some optional metadata that has meaning for MSBuild, which you can define to control build behavior. In jedem Beispiel wurde die folgende Elementdeklaration verwendet, um die Datei C:\MyProject\Source\Program.cs in das Projekt aufzunehmen.In each example, the following item declaration was used to include the file C:\MyProject\Source\Program.cs in the project.

<ItemGroup>
    <MyItem Include="Source\Program.cs" />
</ItemGroup>
ElementmetadatenItem metadata BeschreibungDescription
%(FullPath)%(FullPath) Enthält den vollständigen Pfad des Elements.Contains the full path of the item. Beispiel:For example:

C:\MyProject\Source\Program.csC:\MyProject\Source\Program.cs
%(RootDir)%(RootDir) Enthält das Stammverzeichnis des Elements.Contains the root directory of the item. Beispiel:For example:

C:\C:\
%(Filename)%(Filename) Enthält den Dateinamen des Elements ohne Erweiterung.Contains the file name of the item, without the extension. Beispiel:For example:

ProgramProgram
%(Extension)%(Extension) Enthält die Dateierweiterung des Elements.Contains the file name extension of the item. Beispiel:For example:

.cs.cs
%(RelativeDir)%(RelativeDir) Enthält den im Include-Attribut angegebenen Pfad, bis zum abschließenden umgekehrten Schrägstrich (\).Contains the path specified in the Include attribute, up to the final backslash (\). Zum Beispiel:For example:

Source\Source\

Wenn das Include-Attribut ein vollständiger Pfad ist, beginnt %(RelativeDir) mit dem Stammverzeichnis %(RootDir).If the Include attribute is a full path, %(RelativeDir) begins with the root directory %(RootDir). Beispiel:For example:

C:\MyProject\Source\C:\MyProject\Source\
%(Directory)%(Directory) Enthält das Verzeichnis des Elements ohne das Stammverzeichnis.Contains the directory of the item, without the root directory. Zum Beispiel:For example:

MyProject\Source\MyProject\Source\
%(RecursiveDir)%(RecursiveDir) Wenn das Include-Attribut das Platzhalterzeichen ** enthält, geben diese Metadaten den Teil des Pfads an, der das Platzhalterzeichen ersetzt.If the Include attribute contains the wildcard **, this metadata specifies the part of the path that replaces the wildcard. Weitere Informationen zu Platzhaltern finden Sie unter Vorgehensweise: Auswählen von Dateien für den Buildvorgang.For more information on wildcards, see How to: Select the files to build.

Wenn der Ordner C:\MySolution\MyProject\Source\ die Datei Program.cs enthält, und wenn die Projektdatei dieses Element enthält:If the folder C:\MySolution\MyProject\Source\ contains the file Program.cs , and if the project file contains this item:

<ItemGroup>

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

</ItemGroup>

ist der Wert von %(MyItem.RecursiveDir) gleich \MyProject\Source\ .then the value of %(MyItem.RecursiveDir) would be MySolution\MyProject\Source\.
%(Identity)%(Identity) Das im Include-Attribut angegebene Element.The item specified in the Include attribute. Beispiel:For example:

Source\Program.csSource\Program.cs
%(ModifiedTime)%(ModifiedTime) Enthält den Zeitstempel vom Zeitpunkt der letzten Änderung des Elements.Contains the timestamp from the last time the item was modified. Zum Beispiel:For example:

2004-07-01 00:21:31.5073316
%(CreatedTime)%(CreatedTime) Enthält den Zeitstempel vom Zeitpunkt der Erstellung des Elements.Contains the timestamp from when the item was created. Zum Beispiel:For example:

2004-06-25 09:26:45.8237425
%(AccessedTime)%(AccessedTime) Enthält den Zeitstempel vom Zeitpunkt des letzten Zugriffs auf das Element.Contains the timestamp from the last time the item was accessed.

2004-08-14 16:52:36.3168743

Siehe auchSee also