Guide pratique pour utiliser des caractères spéciaux d’échappement dans MSBuildHow to: Escape special characters in MSBuild

Certains caractères ont une signification spéciale dans les fichiers projet MSBuildMSBuild.Certain characters have special meaning in MSBuildMSBuild project files. Il s’agit par exemple des points-virgules (;) et des astérisques (*).Examples of the characters include semicolons (;) and asterisks (*). Pour obtenir la liste complète de ces caractères spéciaux, consultez Caractères spéciaux MSBuild.For a complete list of these special characters, see MSBuild special characters.

Pour utiliser ces caractères spéciaux en tant que littéraux dans un fichier projet, vous devez les spécifier à l’aide de la syntaxe %<xx>, où <xx> représente la valeur hexadécimale ASCII du caractère.In order to use these special characters as literals in a project file, they must be specified by using the syntax %<xx>, where <xx> represents the ASCII hexadecimal value of the character.

Caractères spéciaux MSBuildMSBuild special characters

Par exemple, les caractères spéciaux sont utilisés dans l’attribut Include des listes d’éléments.One example of where special characters are used is in the Include attribute of item lists. Par exemple, la liste d’éléments suivante déclare deux éléments : MyFile.cs et MyClass.cs.For example, the following item list declares two items: MyFile.cs and MyClass.cs.

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

Si vous souhaitez déclarer un élément qui contient un point-virgule dans le nom, vous devez utiliser la syntaxe %<xx> pour insérer le point-virgule dans une séquence d’échappement et empêcher MSBuildMSBuild de déclarer deux éléments distincts.If you want to declare an item that contains a semicolon in the name, you must use the %<xx> syntax to escape the semicolon and prevent MSBuildMSBuild from declaring two separate items. Par exemple, l’élément suivant insère le point-virgule dans une séquence d’échappement et déclare un élément nommé MyFile.cs;MyClass.cs.For example, the following item escapes the semicolon and declares one item named MyFile.cs;MyClass.cs.

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

Pour utiliser un caractère spécial MSBuild comme caractère littéralTo use an MSBuild special character as a literal character

  • Utilisez la notation %<xx> à la place du caractère spécial, où <xx> représente la valeur hexadécimale du caractère ASCII.Use the notation %<xx> in place of the special character, where <xx> represents the hexadecimal value of the ASCII character. Par exemple, pour utiliser un astérisque (*) comme caractère littéral, utilisez la valeur %2A.For example, to use an asterisk (*) as a literal character, use the value %2A.

Voir aussiSee also

Concepts MSBuild MSBuild concepts
MSBuild MSBuild
ÉlémentsItems