Многострочные строковые литералы в C#: как записать длинный текст без экранирования?

Решение: вербатимные строки (verbatim strings) и необработанные строковые литералы (raw string literals)

В C# есть два отличных способа работать с многострочным текстом. Первый — это вербатимные строки (добавлены с C# 1.0), второй — необработанные строковые литералы (появились в C# 11). Рассмотрим оба.

1. Вербатимные строки с префиксом @

Если поставить символ @ перед открывающей кавычкой, строка становится "буквальной" — все символы внутри интерпретируются как есть, включая переносы строк. Экранирование кавычек делается удвоением: "".

string query = @"SELECT * FROM Users
WHERE Age > 18
ORDER BY Name;";

string json = @"{
    ""name"": ""John"",
    ""age"": 30,
    ""city"": ""New York""
}";

Console.WriteLine(query);
Console.WriteLine(json);

Обратите внимание: открывающая кавычка должна быть на той же строке, что и @, иначе в начале строки появится лишний перенос. Удвоение кавычек ("") — это единственное неудобство, но для SQL-запросов или текста с редкими кавычками это нормально.

2. Необработанные строковые литералы (C# 11 и .NET 7+)

Это современный и самый чистый способ. Используются тройные кавычки """. Внутри можно писать любой текст без экранирования, включая кавычки (кроме последовательности из трёх кавычек подряд). Переносы строк сохраняются как есть.

string query = """
    SELECT * FROM Users
    WHERE Age > 18
    ORDER BY Name;
    """;

string json = """
    {
        "name": "John",
        "age": 30,
        "city": "New York"
    }
    """;

Console.WriteLine(query);
Console.WriteLine(json);

Важные детали:

• Открывающие """ должны быть на отдельной строке, и после них сразу идёт перевод строки.
• Закрывающие """ тоже на отдельной строке. Отступ внутри строки определяется отступом закрывающих кавычек — весь текст будет выровнен относительно них. Это позволяет красиво форматировать код.
• Если нужно включить в текст три кавычки подряд, их можно экранировать, но на практике это редко требуется.

Пример с интерполяцией (C# 11):

string name = "Alice";
int age = 25;
string message = $$"""
    Hello, {{name}}!
    You are {{age}} years old.
    """;
Console.WriteLine(message); // Hello, Alice! You are 25 years old.

Обратите внимание на $$ — это маркер интерполяции для необработанных строк. Количество знаков $ определяет, сколько фигурных скобок нужно для подстановки.

Когда что использовать?

• Если ваш проект на старой версии C# (до 11) — используйте @"". Это надёжно и работает везде.
• Если у вас C# 11+ и вы пишете JSON, XML, SQL, конфиги — используйте """. Это чище и не требует удвоения кавычек.

Больше не нужно мучиться с \n и экранированием. Выбирайте подходящий вариант и пишите читаемый код!

using System.Reflection;

string query;
var assembly = Assembly.GetExecutingAssembly();
using (var stream = assembly.GetManifestResourceStream("YourNamespace.query.sql"))
using (var reader = new StreamReader(stream))
{
    query = reader.ReadToEnd();
}