Freigeben über

Text eines unformatierten Zeichenfolgenliterals: """ in Zeichenfolgenliteralen

Ein unformatiertes Zeichenfolgenliteral beginnt und endet jeweils mit mindestens drei doppelten Anführungszeichen ("):

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

Unformatierte Zeichenfolgenliterale können mehrere Zeilen umfassen:

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

Die folgenden Regeln steuern die Interpretation eines mehrzeiligen unformatierten Zeichenfolgenliterals:

  • Die einleitenden Anführungszeichen müssen das letzte Nichtkommentartoken in der jeweiligen Zeile sein, und die schließenden Anführungszeichen müssen das erste Nichtkommentartoken in der jeweiligen Zeile sein.
  • Leerzeichen, die sich links von den schließenden Anführungszeichen befinden, werden aus allen Zeilen des unformatierten Zeichenfolgenliterals entfernt.
  • Leerzeichen nach dem öffnenden Anführungszeichen in der gleichen Zeile werden ignoriert.
  • Nur aus Leerzeichen bestehende Zeilen nach dem öffnenden Anführungszeichen werden in das Zeichenfolgenliteral eingeschlossen.
  • Wenn ein Leerraum vor dem Endtrennzeichen in derselben Zeile steht, müssen die genaue Anzahl und Art der Leerzeichen (z. B. Leerzeichen vs. Tabs) am Anfang jeder Inhaltszeile vorhanden sein. Insbesondere stimmt ein Leerzeichen nicht mit einem horizontalen Tabulator überein und umgekehrt.
  • Der Zeilenumbruch vor den schließenden Anführungszeichen ist nicht in der Zeichenfolge enthalten.

Möglicherweise müssen Sie ein unformatiertes Zeichenfolgenliteral erstellen, das drei oder mehr aufeinander folgende doppelte Anführungszeichen enthält. Unformatierte Zeichenfolgenliterale können mit einer Sequenz von mindestens drei doppelten Anführungszeichen beginnen und enden. Wenn Ihr Zeichenfolgenliteral drei aufeinanderfolgende doppelte Anführungszeichen enthält, beginnen und beenden Sie das unformatierte Zeichenfolgenliteral mit vier doppelten Anführungszeichen:

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

Wenn Sie ein unformatiertes Zeichenfolgenliteral mit Anführungszeichen beginnen oder beenden müssen, verwenden Sie das mehrzeilige Format:

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

Rohzeichenfolgenliterale können auch mit interpolierten Zeichenfolgen kombiniert werden, um die Zeichen { und } in die Ausgabezeichenfolge einzubetten. Sie können mehrere $-Zeichen in einem interpolierten unformatierten Zeichenfolgenliteral verwenden, um die Zeichen { und } in die Ausgabezeichenfolge einzubetten, ohne sie mit Escapezeichen zu versehen.

Der Inhalt des unformatierten Zeichenfolgenliterals darf keinen Satz zusammenhängender "-Zeichen enthalten, deren Länge gleich oder größer als die Länge des Trennzeichens des unformatierten Zeichenfolgenliterals ist. Beispielsweise sind die Zeichenfolgen """" """ """" und """"""" """""" """"" """" """ """"""" wohlgeformt. Die Zeichenfolgen """ """ """ und """ """" """ sind dagegen schlecht geformt.

Unformatierte Zeichenfolgenliterale wurden in C# 11 eingeführt.

Weitere Informationen