Partager via

Texte de littéral de chaîne brute - """ dans les littéraux de chaîne

Un littéral de chaîne brute commence et finit par trois guillemets doubles au minimum (") :

var singleLine = """This is a "raw string literal". It can contain characters like \, ' and ".""";

Les littéraux de chaîne brute peuvent s’étendre sur plusieurs lignes :

var xml = """
        <element attr="content">
            <body>
            </body>
        </element>
        """;

Les règles suivantes régissent l’interprétation d’un littéral de chaîne brute multiligne :

  • Les guillemets ouvrants doivent être le dernier jeton sans commentaire sur leur ligne respective et les guillemets fermants doivent être le premier jeton sans commentaire sur leur ligne respective.
  • Les espaces blancs situés à gauche des guillemets fermants sont supprimés de toutes les lignes du littéral de chaîne brute.
  • Les espaces blancs qui suivent le guillemet ouvrant sur la même ligne sont ignorés.
  • Les lignes qui ne contiennent que des espaces blancs à la suite du guillemet ouvrant sont incluses dans le littéral de chaîne.
  • Si un espace blanc précède le délimiteur de fin sur la même ligne, le nombre exact et le type de caractères d’espace blanc (par exemple, les espaces et les onglets) doivent exister au début de chaque ligne de contenu. Plus précisément, un espace ne correspond pas à une tabulation horizontale, et inversement.
  • La nouvelle ligne avant les guillemets fermants n’est pas incluse dans la chaîne de caractères littérale.

Vous devrez peut-être créer un littéral de chaîne brute comportant au moins trois guillemets doubles consécutifs. Les littéraux de chaîne brute peuvent commencer et finir par une séquence d’au moins trois guillemets doubles. Quand votre littéral de chaîne contient trois guillemets doubles consécutifs, vous devez commencer et finir le littéral de chaîne brute par quatre guillemets doubles :

var moreQuotes = """" As you can see,"""Raw string literals""" can start and end with more than three double-quotes when needed."""";

Si vous devez commencer ou finir un littéral de chaîne brute par des guillemets, utilisez le format multiligne :

var MultiLineQuotes = """"
               """Raw string literals""" can start and end with more than three double-quotes when needed.
               """";

Les littéraux de chaîne brute peuvent également être combinés avec des chaînes interpolées pour intégrer les caractères { et } dans la chaîne de sortie. Vous pouvez utiliser plusieurs caractères $ dans un littéral de chaîne brute interpolée pour incorporer les caractères { et } dans la chaîne de sortie sans qu’ils fassent l’objet de séquences d’échappement.

Le contenu du littéral de chaîne brute ne doit pas contenir un ensemble de caractères " contigus dont la longueur est égale ou supérieure à la longueur du délimiteur du littéral de chaîne brute. Par exemple, les chaînes """" """ """" et """"""" """""" """"" """" """ """"""" sont bien formées. Toutefois, les chaînes """ """ """ et """ """" """ sont mal formées

Les littéraux de chaîne brute ont été introduits dans C# 11.

Voir aussi