Если вы создаёте новый API на .NET 9 или .NET 10 и ищете привычную страницу документации, её больше нет.

Годами в стандартном шаблоне использовался Swashbuckle, а интерактивная документация появлялась сразу из коробки. Теперь всё изменилось. Фреймворк сам генерирует OpenAPI-документ, а встроенный UI больше не входит в шаблон по умолчанию.

На первый взгляд кажется, что это потеря. Но потом становится понятно, что пришло на замену. Фреймворк сам создаёт OpenAPI-спеку одним вызовом. Дальше можно подключить современный UI поверх этой спеки.

Я обычно использую Scalar: он быстрый, сразу хорошо выглядит и работает с тем же документом, который уже генерирует фреймворк.

Главное изменение — поменялось место, где находится ответственность за описание API. Теперь OpenAPI-спека принадлежит самому фреймворку, а не сторонней библиотеке UI, которую приходится накручивать поверх. Интерфейс документации становится тонким слоем, который можно заменить без изменения процесса генерации спеки.

Старый вариант всё ещё можно оставить — достаточно вручную установить нужный пакет. Но если вы всё равно обновляетесь, это хороший момент убрать одну зависимость и заодно получить более современный UI.

👉 @KodBlog

Анонсирована v2.0 официального MCP SDK для C#.

MCP C# SDK 2.0 реализует спецификацию от 28 июля 2026 года и включает:
- протокол с приоритетом на stateless-режим работы;
- стандартизированные HTTP-заголовки;
- поддержку Multi Round-Trip Requests для интерактивных инструментов.

При этом SDK сохраняет обратную совместимость с предыдущими версиями.

👉 @KodBlog

В C# 15 появятся break и continue с метками.

«Они заменят обходные решения для управления потоком выполнения во вложенных циклах: например, булевый флаг, который устанавливается во внутреннем цикле и затем проверяется на каждом внешнем уровне, или goto, перескакивающий за пределы циклов».

👉 @KodBlog

Блог .NET: от сгенерированного кода к проверенному с помощью агента для написания юнит-тестов.

https://devblogs.microsoft.com/dotnet/polyglot-unit-testing-agent/

👉 @KodBlog

Middleware, но для исходящих HTTP-запросов?
Да, в ASP.NET Core такое есть.

DelegatingHandler позволяет добавлять дополнительную логику вокруг исходящих запросов.
Это похоже на middleware, только работает в обратном направлении.

Отличный сценарий использования? Добавление заголовков аутентификации в запрос.

👉 @KodBlog

Агенты Copilot Studio получили полноценные корпоративные идентификаторы.

Теперь каждому новому агенту автоматически выдаётся собственный Microsoft Entra Agent ID. Отключить это нельзя.
После публикации агента разрешения поддерживаемых коннекторов Power Platform отображаются прямо в его профиле в Entra.

Администраторы могут:

Видеть, к каким сервисам настроено обращение агента
Проверять историю входов
Управлять его жизненным циклом
Настраивать доступ к коннекторам через Conditional Access

DLP и Advanced Connector Policies по-прежнему контролируют доступ во время выполнения.
Теперь у агента есть собственный идентификатор, назначенный ответственный, видимые разрешения, журналы и политики.

Именно такой уровень управления был нужен корпоративным агентам.

Пока есть одно ограничение: сквозное применение Conditional Access по Agent ID к вызовам коннекторов сейчас работает только в Teams. При этом разрешения видны во всех каналах.

Microsoft готовит серьёзные вещи.

👉 @KodBlog

В .NET 11 появилось множество изменений в JIT (они также применяются к Native AOT), которые устраняют избыточные проверки границ массива. Цель — сделать безопасный код таким же быстрым, как и unsafe.

Эти изменения можно отслеживать по метке reduce-unsafe. Один из примеров улучшений — по ссылке ниже.

https://github.com/EgorBot/Benchmarks/issues/169

#dotnet

👉 @KodBlog

А вы знали? Теперь в C# есть ключевое слово safe 🙃

Оно обязательно для всех P/Invoke-объявлений и полей в структурах с explicit или extended layout. Нужно явно указать либо safe, либо unsafe — если не указать модификатор, код не скомпилируется.

👉 @KodBlog

Что предпочитаете? 😂

ForLoop (1) или GotoLoop (2)

#dotnet

👉 @KodBlog

Интересный эксперимент: windows-csharp

https://github.com/microsoft/windows-rs/pull/4777

Генератор C#, который строит проекции Windows API из метаданных Windows, но вместо обёрток CsWinRT генерирует прямые вызовы COM/ABI. Без WinRT.Runtime.dll и без SDK projections.

Это пока не полноценная замена (?), но уже работает с реальными приложениями на базе Composition/WinUI. 🤔

👉 @KodBlog

Что такое breaking change для API?

Вот несколько примеров:
> Удаление или переименование API-методов или параметров API.
> Изменение поведения существующих API.
> Изменение кодов ошибок API.

Breaking change означает, что вам нужно версионировать API — иначе вы рискуете сломать существующих потребителей API.

К счастью, ASP.NET Core упрощает добавление версионирования API.

И ещё немного спорное мнение: версионирование API должно быть крайней мерой.

👉 @KodBlog

Знали ли вы, что обмен сообщениями можно использовать по схеме request–response?

Один сервис — отправитель запроса — посылает сообщение с запросом и ожидает соответствующее ответное сообщение. Со стороны отправителя это выглядит как синхронное взаимодействие.

Вот как выглядит такой поток.

Плюсы:
Слабая связанность ✅
Прозрачность расположения сервисов ✅

Минусы:
Высокая задержка ❌
Дополнительная сложность реализации ❌

Я реализовывал такой подход с RabbitMQ и NATS — в обоих случаях он отлично себя показал.

👉 @KodBlog

Как контролировать соблюдение архитектурных правил в проекте?

Возможности компилятора C# здесь довольно ограничены, а проверять всё вручную на код-ревью дорого.

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

Это автоматические тесты, которые проверяют структуру и устройство кода.

С их помощью можно задавать архитектурные правила прямо на C#:

* контролировать направление зависимостей между проектами;
* задавать правила именования классов;
* требовать, чтобы классы были sealed.

👉 @KodBlog

Новое в .NET 11:

Сжатие HTTP-запросов с помощью GZip, Brotli и Zstandard.

👉 @KodBlog

О правилах Clean Architecture спорят много. Но по-настоящему важно только одно.

Зависимости направлены внутрь.

Посмотрите на схему. Web.Api находится снаружи. Затем Infrastructure. Затем Application. В центре — Domain, и он ничего не знает ни об одном из этих слоёв.

В вашем Domain нет зависимостей от базы данных, веб-фреймворка или сервиса отправки почты. Там только бизнес-правила на обычном C#.

Что это даёт:

* Можно заменить Postgres на что-то другое, не меняя Domain. Хотя лучше не надо.
* Можно тестировать бизнес-правила вообще без базы данных — быстрыми юнит-тестами, которые могут написать ваши агенты.
* Новый разработчик может разобраться в ядре приложения, не изучая весь стек.

Понять это правило легко. Намного сложнее не нарушить его спустя шесть месяцев дедлайнов.

Поэтому в моём шаблоне есть архитектурные тесты, которые валят сборку в тот момент, когда внутренний слой нарушает это правило.

👉 @KodBlog

C# 15 позволяет объявить тип, который может быть только одним из заранее заданного набора других типов.

Union types. Новое ключевое слово, одна строка, базовый класс не нужен.

public record class Cat(string Name);
public record class Dog(string Name);
public record class Bird(string Name);

public union Pet(Cat, Dog, Bird);

Теперь Pet может содержать Cat, Dog или Bird — и ничего больше.

Pet pet = new Dog("Rex");

string name = pet switch
{
    Dog d => d.Name,
    Cat c => c.Name,
    Bird b => b.Name,
};

✔️ Неявное преобразование каждого из допустимых типов напрямую в union
✔️ Компилятор заставляет switch обработать все варианты — пропустите один, и проект не соберётся
✔️ Не нужна иерархия наследования, класс-обёртка или ручные проверки в духе «это Cat или Dog»

Пока это предварительная функция в .NET 11, поэтому синтаксис ещё может измениться до релиза.

Но попробовать уже сейчас вполне можно, если хотите заранее разобраться с новой возможностью.

👉 @KodBlog

Пробовали IExceptionHandler в .NET 10?

Это более простой способ глобально обрабатывать исключения. IExceptionHandler встроен в стандартный middleware обработки ошибок.

Можно обрабатывать либо все исключения, либо только конкретные типы. А значит, обработчики можно выстраивать в цепочку.

👉 @KodBlog

Если достаточно долго работать с базами данных, рано или поздно столкнёшься с проблемами подключений или параллелизма.

В такой ситуации не стоит просто повышать лимиты в конфигурации. Лучше разобраться в архитектуре, чтобы понимать, почему это происходит и как исправить проблему оптимальным способом.

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

Легко свести всё к особенностям Postgres с отдельным процессом на каждое соединение, но похожие проблемы могут возникать и в других базах данных, включая MySQL.

Часто ответ кроется в пуле подключений, но и он добавляет свою сложность, которую тоже важно понимать.

Статье уже 8 лет, но для Postgres она остаётся актуальной и в 2026 году.

Ссылка ниже.

https://brandur.org/postgres-connections

👉 @KodBlog