📎 Когда тип спасает

Представьте, что вы пришли в магазин и продавец говорит: «Вот вам что-то. Не знаю что. Может быть, помидоры, может быть, кирпич, может быть, счастье. Узнаете, когда вернётесь домой». Вот такое же ощущение от IActionResult без типов.

Проблема с IActionResult:

[HttpGet("{id:guid}")]
public async Task<IActionResult> GetById(Guid id, ISender mediator, CancellationToken ct)
{
    var dto = await mediator.Send(new GetUserQuery(id), ct);
    return dto is null ? NotFound() : Ok(dto);
}

Возвращаемый тип — IActionResult. Просто интерфейс. Ничего конкретного. Кто читает этот код, не знает, что именно вернётся. Может быть UserDto, может быть ошибка, может быть что угодно.

Вот так выглядит сгенерированная Swagger документация:

{
  "responses": {
    "200": { "description": "Success" }
  }
}

Никакой информации о схеме. Кто использует ваш API, не знает, какие поля будут в ответе. IDE не может подсказать структуру. Тесты пишутся вслепую.

Решение: ActionResult<T>

[HttpGet("{id:guid}")]
public async Task<ActionResult<UserDto>> GetById(Guid id, ISender mediator, CancellationToken ct)
{
    var dto = await mediator.Send(new GetUserQuery(id), ct);
    return dto is null ? NotFound() : Ok(dto);
}

Возвращаемый тип — ActionResult<UserDto>. Конкретно и ясно. Читающий код понимает мгновенно: метод возвращает UserDto при успехе или ошибку. Swagger генератор видит типы и строит правильную документацию.

IActionResult можно использовать, когда метод не возвращает тело, к примеру ответ 204.

🐸Библиотека шарписта

#sharp_view

👨‍💻 Demystifier: когда стек-трейс не радует

Откройте логи ошибки из продакшена. Видите стек-трейс? Он полон <>c__DisplayClass2_0, d__5``1.MoveNext() и прочих артефактов, которые сгенерировал компилятор. Это не ошибка — это просто то, как .NET преобразует современный C# в IL. Но это делает поиск проблемы медленнее, чем нужно.

Demystifier восстанавливает оригинальный вид кода:

• Вместо ValueTuple``2 param показывает (string val, bool) param
• Вместо Func``1 показывает Func<string>
• async методы помечает как async Task<string>
• Локальные функции и лямбды показывает с контекстом

Как применить

Вызовите exception.Demystify() и передайте результат:

try { /* ваш код */ }
catch (Exception ex)
{
    logger.LogError(ex.Demystify(), "Ошибка");
}

Анализ стека стоит ресурсов. На высоконагруженной системе вызывать Demystify для каждого исключения неэкономно. Используйте его выборочно — для критических путей, для отладки в development окружении или для редких, но важных ошибок.

➡️ Репозиторий либы

🐸Библиотека шарписта

#sharp_view

📎 Как считать повторения без условных операторов

Нужно посчитать, сколько раз каждое значение встречается в данных. Логично напрашивается проверка:

if (counts.ContainsKey(key))
    counts[key]++;
else
    counts[key] = 1;

Но есть способ проще:

counts[key] = counts.GetValueOrDefault(key) + 1;

Метод GetValueOrDefault возвращает значение, если ключ есть, или значение по умолчанию (для int это 0). Затем добавляем единицу. Никаких условных операторов, одна строка.

Если можете — используйте LINQ:

var counts = items.GroupBy(x => x.Key)
    .ToDictionary(g => g.Key, g => g.Count());

Это явно показывает намерение: группируем по ключу, считаем количество в каждой группе.
Но если вы наполняете словарь в цикле или обрабатываете поток данных, GetValueOrDefault — идеальный выбор.

🐸Библиотека шарписта

#sharp_view

⭐️ Microsoft обновила дорожную карту в Visual Studio на ноябрь

Компания работает над несколькими направлениями, которые должны сделать IDE более интегрированной с AI.
Новые агенты для обработки сложных workflow, улучшения в режиме Agent Mode и Chat, а также поддержка работы нескольких агентов одновременно.

По части моделей Microsoft планирует добавить автоматический выбор модели в Chat, GPT-5 Codex, улучшить UX для устаревающих моделей и поддержку разных системных промптов для каждой модели.

Microsoft ставит цель сделать Copilot доступным на каждом этапе разработки — не только для написания кода, но и для поиска, исправления ошибок, написания тестов, коммитов.

➡️ Блог разработчиков

🐸Библиотека шарписта

#async_news

🤩 Lorem ipsum, который имитирует научный вздор

Представьте: нужно заполнить макет контентом, чтобы дизайнер видел, как всё выглядит. Берёте Lorem ipsum. Но он выглядит как набор слов. А если нужен текст, который с первого взгляда кажется серьезным, но при внимательном чтении — полная чушь? Вот для этого WaffleGenerator.

Это библиотека, которая генерирует абзацы в стиле научно-популярного бреда. Текст выглядит настоящим: правильная структура, логичные переходы, официальный тон. Но если вы прочитаете внимательно, поймёте, что там просто красивые слова без смысла.

Как применить

Просто:

var text = WaffleEngine.Html(paragraphs: 2, includeHeading: true);
var text = WaffleEngine.Text(paragraphs: 1, includeHeading: true);
var markdown = WaffleEngine.Markdown(paragraphs: 1, includeHeading: true);

Поддерживает три формата: HTML, обычный текст и Markdown.

➡️ Попробовать либу

🐸Библиотека шарписта

#sharp_view

💬 Всё, что вам нужно знать о главном событии года для .NET разработчиков

Через неделю начинается самая важная конференция для .NET сообщества — .NET Conf 2025. С 11 по 13 ноября пройдёт трёхдневная бесплатная виртуальная конференция, где будет официально представлена .NET 10 и показаны новые возможности Visual Studio 2026.

Самые интересные сессии первого дня:

• C# 14: Новые языковые фичи — улучшенная ясность кода и новые паттерны программирования

• Производительность .NET 10 — оптимизации во всей платформе и компиляторе
Blazor в .NET 10 — WebAuthN, passkeys, улучшенная диагностика и производительность

• Aspire: облачная разработка — опinionated фреймворк для observable, production-ready распределённых приложений

• Agentic Development — как строить AI-агентов, которые могут рассуждать, планировать и действовать

• .NET MAUI обновления — новые компоненты, производительность, улучшенный tooling

Второй день:

• Облачная разработка с Azure — контейнеры, K8s, функции и AI-сервисы

• Remote MCP servers — как строить собственные интеграции

• Redis интеграция с .NET

• Расширение и кастомизация Aspire — custom integrations и расширенный функционал

• Microsoft.Testing.Platform — новый фреймворк тестирования

➡️ Анонс от Microsoft

🐸Библиотека шарписта

#async_news

👁 Что-то неладное..

🐸Библиотека шарписта

#garbage_collector

👨‍💻 IOptions vs IOptionsSnapshot vs IOptionsMonitor

В .NET существует несколько интерфейсов для работы с настройками: IOptions, IOptionsSnapshot и IOptionsMonitor. Помогаем разобраться, какой из них когда нужен.

IOptions — загружает конфигурацию однажды при запуске и всегда возвращает одно и то же значение:

public class MyService
{
    private readonly MySettings _settings;

    public MyService(IOptions<MySettings> options)
    {
        _settings = options.Value;
    }

    public void PrintSettings()
    {
        Console.WriteLine($"API Key: {_settings.ApiKey}");
    }
}

Это подходит для статичных настроек, которые не меняются во время работы приложения.

IOptionsSnapshot — создаётся на каждый запрос или скоуп и предоставляет новые значения при каждом новом запросе:

public class MyScopedService
{
    private readonly MySettings _settings;

    public MyScopedService(IOptionsSnapshot<MySettings> options)
    {
        _settings = options.Value;
    }

    public void PrintSettings()
    {
        Console.WriteLine($"Timeout: {_settings.Timeout}");
    }
}

Подходит для веб-приложений, где конфигурация может меняться между запросами.

IOptionsMonitor — позволяет подписаться на изменения и получать обновления конфигурации в реальном времени:

public class MyMonitorService
{
    private MySettings _settings;

    public MyMonitorService(IOptionsMonitor<MySettings> monitor)
    {
        _settings = monitor.CurrentValue;
        monitor.OnChange(updatedSettings =>
        {
            _settings = updatedSettings;
            Console.WriteLine("Settings updated!");
        });
    }

    public void PrintSettings()
    {
        Console.WriteLine($"LogLevel: {_settings.LogLevel}");
    }
}

Подходит для длительно работающих приложений, которые должны реагировать на изменения конфигурации без перезапуска.

🐸Библиотека шарписта

#sharp_view

📰 Дайджест недели

Вспоминаем что произошло за последние три рабочих дня и четыре выходных

— Релиз SQLite 3.51.0

В новой версии SQLite оптимизирована работа с запросами, расширена поддержка SQL и исправлены критичные ошибки.

— Управление доступом в .NET

— Demystifier

— Дорожная карта Visual Studio

— Скоро .NET Conf 2025

🐸Библиотека шарписта

#async_news

🤩 Doom теперь в Telegram

В Telegram появился порт классической игры Doom, а также Doom II, который теперь запускается прямо внутри WebView виджета.

➡️ Поиграть

🐸Библиотека шарписта

#async_news

⚡️ Когда важна производительность

В C# цикл foreach часто воспринимается как самая удобная и красивая форма для обхода коллекций. Но в вопросах производительности foreach не всегда оптимален.

Почему лучше избегать foreach:

• foreach использует итератор — для массивов его оптимизируют, но для списков, словарей и других коллекций создаётся объект или struct-итератор.

• под капотом foreach может создавать временные объекты, что увеличивает нагрузку на сборщик мусора и снижает производительность.

• foreach всегда выполняет проверки и гарантирует корректность обхода, но это стоит некоторой производительности.

Что использовать вместо foreach:

Цикл for с индексом, особенно для массивов:

for (int i = 0; i < data.Length; i++)
{
    // работа с data[i]
}

Span<T> и его методы — для обхода данных без выделения памяти и избыточных проверок:

var span = data.AsSpan();
for (int i = 0; i < span.Length; i++)
{
    // работа с span[i]
}

Когда можно использовать foreach:

• Если цикл выполняется нечасто или количество элементов небольшое.

• Для обхода коллекций, где критичен чистый и понятный стиль программирования.

🐸Библиотека шарписта

#sharp_view

⭐️ Иммутабельность без танцев с бубном

Records — это ссылочный тип, который упростил жизнь разработчикам, привыкшим писать иммутабельные классы вручную. Вот зачем они нужны.

Раньше иммутабельный класс требовал много кода: readonly свойства, отключённые сеттеры, кастомные конструкторы. И всё равно где-то находилась лазейка. С Records это просто исчезает:

public record User(string Name, string Email);

var user = new User("Алексей", "alex@example.com");
// user.Name = "Новое имя"; — Ошибка компиляции

Все свойства автоматически получают init-accessor. Установить значение можно только при создании объекта. Это не просто синтаксический сахар — это гарантия от багов состояния, которые трудно найти.

Если вам нужен объект инициализатор, Records это поддерживают:

public record Product
{
    public string Name { get; init; }
    public decimal Price { get; init; }
}

var book = new Product { Name = "C# Deep Dive", Price = 49.99M };

Проще тестировать, проще рассуждать о коде, проще избежать багов в многопоточной среде. А ошибки, связанные с неожиданным изменением состояния, просто перестают существовать.

🐸Библиотека шарписта

#sharp_view

👀 .NET Conf 2025 — День 1

Сегодня начинается 15-я ежегодная виртуальная конференция .NET Conf 2025.

В первый день будут доклады по C# 14, производительности .NET 10, обновлениям Blazor, фреймворку Aspire, Agentic Development и .NET MAUI. Второй день посвящён облачной разработке с Azure, интеграциям Remote MCP серверов, Redis, расширениям Aspire и новому фреймворку тестирования Microsoft.Testing.Platform

➡️ Трансляция

🐸Библиотека шарписта

#async_news