Zápis speciálních znaků pomocí escape sekvence v nástroji MSBuild

  • Článek

Některé znaky mají zvláštní význam v souborech projektu MSBuild. Mezi příklady znaků patří středníky (;) a hvězdičky (*). Úplný seznam těchto speciálních znaků najdete v tématu Speciální znaky nástroje MSBuild.

Aby bylo možné tyto speciální znaky použít jako literály v souboru projektu, musí být zadány pomocí syntaxe %<xx>, kde <xx> představuje šestnáctkovou hodnotu znaku ASCII.

Speciální znaky nástroje MSBuild

Jeden příklad, kde se používají speciální znaky, je v Include atributu seznamů položek. Například následující seznam položek deklaruje dvě položky: MyFile.cs a MyClass.cs.

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

Pokud chcete deklarovat položku, která obsahuje středník v názvu, je nutné použít %<xx> syntaxi k řídicímu znaku středníku a zabránit nástroji MSBuild v deklarování dvou samostatných položek. Například následující položka unikne středníku a deklaruje jednu položku s názvem MyFile.cs;MyClass.cs.

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

K řídicím řetězcům můžete také použít funkci vlastnosti. To je například ekvivalentní výše uvedenému příkladu.

<Compile Include="$([MSBuild]::Escape('MyFile.cs;MyClass.cs'))" />

Použití speciálního znaku NÁSTROJE MSBuild jako literálového znaku

Místo speciálního znaku použijte notaci %<xx> , kde <xx> představuje šestnáctkovou hodnotu znaku ASCII. Chcete-li například použít hvězdičku (*) jako literálový znak, použijte hodnotu %2A.

Související obsah