Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Enthält ein benutzerdefiniertes Element und die entsprechenden Metadaten. Jedes in einem MSBuild-Projekt verwendete Element muss als untergeordnetes Element eines ItemGroup-Elements angegeben werden.
<Item Include="*.cs"
Exclude="MyFile.cs"
Condition="'String A'=='String B'" >
<ItemMetadata1>...</ItemMetadata1>
<ItemMetadata2>...</ItemMetadata2>
</Item>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
Include |
Erforderliches Attribut. Die Datei oder der Platzhalter, die bzw. der in das Element eingeschlossen werden soll. |
Exclude |
Optionales Attribut. Die Datei oder der Platzhalter, die bzw. der aus dem Element ausgeschlossen werden soll. |
Condition |
Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen hierzu finden Sie unter MSBuild-Bedingungen. |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
Ein benutzerdefinierter Elementmetadatenschlüssel, der den Elementmetadatenwert enthält. Es kann keine oder mehrere ItemMetadata-Elemente in einem Element geben. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Gruppierungselement für Elemente. |
Hinweise
Item-Elemente definieren Eingaben ins Buildsystem und werden anhand ihrer benutzerdefinierten Auflistungsnamen in Elementauflistungen gruppiert. Diese Elementauflistungen können als Parameter für Aufgaben dienen, in denen die einzelnen Elemente der Auflistung verwendet werden, um die Schritte des Buildprozesses auszuführen. Weitere Informationen hierzu finden Sie unter MSBuild-Elemente.
Mithilfe der Notation @(myType) kann eine Auflistung von Elementen des Typs myType in eine durch Semikolons (;) getrennte Liste von Zeichenfolgen erweitert und an einen Parameter übergeben werden. Wenn der Parameter den Typ string aufweist, entspricht sein Wert der durch Semikolons getrennten Liste von Elementen. Handelt es sich bei dem Parameter um ein Zeichenfolgenarray (string[]), wird jedes einzelne Element in das Array eingefügt. Als Trennzeichen gelten dabei die Semikolons. Wenn der Aufgabenparameter den Typ ITaskItem[] aufweist, entspricht sein Wert dem Inhalt der Elementauflistung einschließlich ggf. angefügter Metadaten. Um die einzelnen Elemente durch ein anderes Zeichen als ein Semikolon voneinander zu trennen, verwenden Sie die Syntax @(myType, 'separator').
Das MSBuild-Modul kann Platzhalter wie * und ? sowie rekursive Platzhalter wie /**/*.cs auswerten. Weitere Informationen hierzu finden Sie unter MSBuild-Elemente.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie zwei Elemente des Typs CSFile deklariert werden. Das zweite deklarierte Element enthält Metadaten, bei denen myAttribute auf HelloWorld festgelegt ist.
<ItemGroup>
<CSFile Include="engine.cs; form.cs" />
<CSFile Include="main.cs" >
<MyMetadata>HelloWorld</MyMetadata>
</Item>
</ItemGroup>