Share via


Gewusst wie: Escapesonderzeichen in MSBuild

Bestimmte Zeichen haben eine besondere Bedeutung in MSBuild-Projektdateien. Zu diesen Zeichen zählen beispielsweise Semikolons (;) und Sternchen (*). Eine vollständige Liste dieser Sonderzeichen finden Sie unter MSBuild-Sonderzeichen.

Um diese Sonderzeichen als Literale in einer Projektdatei zu verwenden, müssen sie mit der Syntax %xx angegeben werden, wobei xx den ASCII-Hexadezimalwert des Zeichens darstellt.

MSBuild-Sonderzeichen

Ein Beispiel für die Verwendung von Sonderzeichen stellt das Include-Attribut in Elementlisten dar. Durch die folgende Elementliste werden beispielsweise die beiden Elemente MyFile.cs und MyClass.cs deklariert.

<Compile Include="MyFile.cs;MyClass.cs"/>

Wenn Sie ein Element deklarieren möchten, das ein Semikolon im Namen enthält, müssen Sie die Syntax %xx verwenden, um das Semikolon mit einem Escapezeichen zu versehen und zu verhindern, dass MSBuild zwei verschiedene Elemente deklariert. Durch das folgende Element wird das Semikolon beispielsweise mit einem Escapezeichen versehen und ein Element mit dem Namen MyFile.cs;MyClass.cs deklariert.

<Compile Include="MyFile.cs%3BMyClass.cs"/>

So verwenden Sie ein MSBuild-Sonderzeichen als Literalzeichen

  • Verwenden Sie anstelle des Sonderzeichens die %xx-Notation, wobei xx den Hexadezimalwert des ASCII-Zeichens darstellt. Um ein Sternchen (*) als Literalzeichen verwenden zu können, müssten Sie beispielsweise den Wert %2A verwenden.

Siehe auch

Konzepte

MSBuild-Elemente

Weitere Ressourcen

MSBuild Concepts

MSBuild Overview