Тег: aspnetcore

Используйте CreateBuilder для обычного приложения, CreateSlimBuilder, когда публикуете с обрезкой или Native AOT за TLS-прокси, и CreateEmptyBuilder только тогда, когда хотите зарегистрировать все сервисы сами. Вот матрица возможностей и подводные камни, которые определяют выбор.

Output caching -- это правильный вариант по умолчанию почти для любого серверного приложения на ASP.NET Core 11. Response caching выигрывает только тогда, когда ваша цель -- управлять кешами браузеров и прокси через HTTP-заголовки. Вот это решение, с матрицей возможностей и подводными камнями, которые определяют выбор.

Preview 6 добавляет AsyncValidationAttribute и IAsyncValidatableObject, чтобы правила DataAnnotations могли обращаться к базе данных до запуска вашего endpoint, не блокируя поток.

Полное практическое руководство по health checks в minimal API на ASP.NET Core 11: AddHealthChecks и MapHealthChecks, собственные классы IHealthCheck, возвращающие Healthy/Degraded/Unhealthy, зонд EF Core AddDbContextCheck, эндпоинты liveness и readiness на основе тегов для Kubernetes, JSON ResponseWriter, ResultStatusCodes, защита эндпоинта через RequireAuthorization и RequireHost, а также отправка результатов через IHealthCheckPublisher.

Полное рабочее руководство по endpoint-фильтрам в minimal API ASP.NET Core 11: AddEndpointFilter со встроенным делегатом, классы IEndpointFilter с внедрением зависимостей, GetArgument и список Arguments, короткое замыкание через Results.Problem, порядок FIFO/FILO для нескольких фильтров, фильтры на уровне группы с MapGroup и AddEndpointFilterFactory для фильтров, зависящих от сигнатуры.

Preview 6 по умолчанию отклоняет небезопасные межсайтовые запросы браузера, читая заголовок Sec-Fetch-Site вместо токена antiforgery. Вот что она блокирует и как исключить конечные точки.

Kestrel по умолчанию ограничивает тело запроса 30 000 000 байтами и возвращает 413 при превышении. Увеличьте MaxRequestBodySize глобально, для endpoint или в web.config за IIS.

Вы задали заголовок, код состояния или content type после того, как тело уже было сброшено. Задавайте все заголовки до первой записи или защищайтесь через HttpResponse.HasStarted и OnStarting.

Полное руководство по сжатию ответов в ASP.NET Core 11: AddResponseCompression и UseResponseCompression, новый встроенный провайдер Zstandard рядом с Brotli и Gzip, уровни сжатия, EnableForHttps и риск CRIME/BREACH, пользовательские MIME-типы, порядок middleware и когда стоит доверить это обратному прокси.

Объявите тип возврата обработчика как Results<Ok<T>, NotFound> и возвращайте TypedResults.Ok / TypedResults.NotFound: объединение даёт проверку на этапе компиляции того, что обработчик возвращает только то, что объявляет, и само описывает себя для OpenAPI, так что вам никогда не придётся писать .Produces вручную. Рассматриваются асинхронные обработчики, ограничение в шесть типов и тестирование в ASP.NET Core 11.