WriteLinesToFile-Aufgabe
Schreibt die Pfade der angegebenen Elemente in die angegebene Textdatei.
Aufgabenparameter
In der folgenden Tabelle werden die Parameter der WriteLinestoFile-Aufgabe beschrieben.
Parameter |
Beschreibungen |
|---|---|
File |
Erforderlicher ITaskItem-Parameter. Gibt die Datei an, in die die Elemente geschrieben werden sollen. |
Lines |
Optionaler ITaskItem[]-Parameter. Gibt die Elemente an, die in die Datei geschrieben werden sollen. |
Overwrite |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, überschreibt die Aufgabe den Inhalt der Datei, falls vorhanden. |
Encoding |
Optionaler String-Parameter. Wählt die Zeichencodierung aus, z. B. "Unicode". Siehe auch Encoding. |
Hinweise
Wenn Overwrite den Wert true hat, wird eine neue Datei erstellt, der Inhalt in die Datei geschrieben und die Datei anschließend geschlossen. Ist die Zieldatei bereits vorhanden, wird sie überschrieben. Wenn Overwrite false ist, wird der Inhalt an die Datei angefügt, dabei die Ziel-Datei erstellt, wenn Sie nicht bereits vorhanden ist.
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.
Beispiel
Im folgenden Beispiel werden mithilfe der WriteLinesToFile-Aufgabe die Pfade der Elemente in der MyItems-Elementauflistung in die Datei geschrieben, die durch die MyTextFile-Elementauflistung angegeben ist.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyTextFile Include="Items.txt"/>
<MyItems Include="*.cs"/>
</ItemGroup>
<Target Name="WriteToFile">
<WriteLinesToFile
File="@(MyTextFile)"
Lines="@(MyItems)"
Overwrite="true"
Encoding="Unicode"/>
</Target>
</Project>