Форматирование сообщений и сбор значений параметров¶

Сообщением может быть любая строка. Однако, в нее можно включить заполнители, обозначенные фигурными скобками {}:

_log.LogInformation("Loaded {RecipeCount} recipes", Recipes.Count);

Включение заполнителя и значения параметра создаёт пару “ключ-значение”, которую некоторые поставщики журналирования могут хранит в качестве дополнительной информации.
Можно включить несколько заполнителей, и они будут ассоциированы с дополнительными параметрами. Порядок заполнителей должен соответствовать порядку предоставленных параметров:

_log.LogInformation("User {UserId} loaded recipe {RecipeId}", 123, 456);

создаст параметры UserId=123 и RecipeId=456.

Предупреждение

В метод журнала необходимо передать как минимум столько параметров, сколько заполнителей в сообщении. Если параметров будет меньше, то возникнет исключение во время выполнения.

Поставщики структурного журналирования будут хранить эти значения в дополнение к отформатированному сообщению "User 123 loaded recipe 456".

Последнее обновление : 7 мая 2023 г.
Дата создания : 20 октября 2022 г.

Форматирование сообщений и сбор значений параметров¶

Комментарии

Комментарии