Skip to content

Commit 442141b

Browse files
Copilotwadepickett
Copilot
and
wadepickett
authored
Add ASP.NET Core .NET 11 Preview 2 release notes include files (#36856)
* Initial plan * Add Preview 2 release notes include files and update aspnetcore-11.md Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> * Add ai-usage metadata to aspnetcore-11.md Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> * Update infer-passkey-display-name-p2.md Removed product pr links. * Restore source code PR links in infer-passkey-display-name-p2.md Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> * Update infer passkey display name documentation Removed references to GitHub issues in the documentation for clarity. * Remove all source code PR links from Preview 2 include files Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> * Apply suggestion from @wadepickett Date will be updated closer to when this is intended to go live. * Rename include files from -p2 to -preview2 Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> * Update aspnetcore-11.md Removed comment out for breaking changes link since 11 is available. --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> Co-authored-by: Wade Pickett <wpickett@microsoft.com>
1 parent 43e2de9 commit 442141b

5 files changed

Lines changed: 50 additions & 4 deletions

File tree

‎aspnetcore/release-notes/aspnetcore-11.md‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: What's new in ASP.NET Core in .NET 11
3+
ai-usage: ai-assisted
34
author: wadepickett
45
description: Learn about the new features in ASP.NET Core in .NET 11.
56
ms.author: wpickett
@@ -39,12 +40,16 @@ This section describes new features for OpenAPI.
3940

4041
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-binary-file-response.md)]
4142

43+
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/openapi-3-2-support-preview2.md)]
44+
4245
## Authentication and authorization
4346

4447
This section describes new features for authentication and authorization.
4548

4649
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/identity-time-provider.md)]
4750

51+
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/infer-passkey-display-name-preview2.md)]
52+
4853
## Miscellaneous
4954

5055
This section describes miscellaneous new features in .NET 11.
@@ -53,12 +58,11 @@ This section describes miscellaneous new features in .NET 11.
5358

5459
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/development-certificate-trust.md)]
5560

56-
<!-- HOLD - The breaking changes article for 11.0 hasn't been created yet ...
61+
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/native-otel-tracing-preview2.md)]
5762

58-
https://learn.microsoft.com/dotnet/core/compatibility/breaking-changes
63+
[!INCLUDE[](~/release-notes/aspnetcore-11/includes/performance-improvements-preview2.md)]
5964

6065
## Breaking changes
6166

62-
Use the articles in [Breaking changes in .NET](/dotnet/core/compatibility/breaking-changes) to find breaking changes that might apply when upgrading an app to a newer version of .NET.
67+
Use the articles in [Breaking changes in .NET]([/dotnet/core/compatibility/breaking-changes](https://learn.microsoft.com/dotnet/core/compatibility/breaking-changes)) to find breaking changes that might apply when upgrading an app to a newer version of .NET.
6368

64-
-->

‎aspnetcore/release-notes/aspnetcore-11/includes/infer-passkey-display-name-preview2.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
### Infer passkey display name from authenticator
2+
3+
ASP.NET Core Identity now automatically infers friendly display names for passkeys based on their AAGUID (Authenticator Attestation GUID). Built-in mappings are included for the most commonly used passkey authenticators, including Google Password Manager, iCloud Keychain, Windows Hello, 1Password, and Bitwarden.
4+
5+
For known authenticators, the name is automatically assigned without prompting the user. For unknown authenticators, the user is redirected to a rename page. Developers can extend the mappings by adding entries to the `PasskeyAuthenticators.cs` dictionary in their project.

‎aspnetcore/release-notes/aspnetcore-11/includes/native-otel-tracing-preview2.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
### Native OpenTelemetry tracing for ASP.NET Core
2+
3+
ASP.NET Core now natively adds OpenTelemetry semantic convention attributes to the HTTP server activity, aligning with the [OpenTelemetry HTTP server span specification](https://opentelemetry.io/docs/specs/semconv/http/http-spans/#http-server-span). All required attributes are included by default, matching the metadata previously only available through the `OpenTelemetry.Instrumentation.AspNetCore` library.
4+
5+
To collect the built-in tracing data, subscribe to the `Microsoft.AspNetCore` activity source in your OpenTelemetry configuration:
6+
7+
```csharp
8+
builder.Services.AddOpenTelemetry()
9+
.WithTracing(tracing => tracing
10+
.AddSource("Microsoft.AspNetCore")
11+
.AddConsoleExporter());
12+
```
13+
14+
No additional instrumentation library (such as `OpenTelemetry.Instrumentation.AspNetCore`) is needed. The framework now directly populates semantic convention attributes like `http.request.method`, `url.path`, `http.response.status_code`, and `server.address` on the request activity.
15+
16+
If you don't want OpenTelemetry attributes added to the activity, you can turn it off by setting the `Microsoft.AspNetCore.Hosting.SuppressActivityOpenTelemetryData` AppContext switch to `true`.

‎aspnetcore/release-notes/aspnetcore-11/includes/openapi-3-2-support-preview2.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
### OpenAPI 3.2.0 support (Breaking Change)
2+
3+
`Microsoft.AspNetCore.OpenApi` now supports OpenAPI 3.2.0 through an updated dependency on `Microsoft.OpenApi` 3.3.1. This update includes breaking changes from the underlying library — see the [Microsoft.OpenApi upgrade guide](https://github.com/microsoft/OpenAPI.NET/blob/main/docs/upgrade-guide-3.md) for details.
4+
5+
To generate an OpenAPI 3.2.0 document, specify the version when calling `AddOpenApi()`:
6+
7+
```csharp
8+
builder.Services.AddOpenApi(options =>
9+
{
10+
options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_2;
11+
});
12+
```
13+
14+
Subsequent updates will take advantage of new capabilities in the 3.2.0 specification, such as item schema support for streaming events.
15+
16+
Thank you [@baywet](https://github.com/baywet) for this contribution!

‎aspnetcore/release-notes/aspnetcore-11/includes/performance-improvements-preview2.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
### Performance improvements
2+
3+
Kestrel's HTTP/1.1 request parser now uses a non-throwing code path for handling malformed requests. Instead of throwing `BadHttpRequestException` on every parse failure, the parser returns a result struct indicating success, incomplete, or error states. In scenarios with many malformed requests — such as port scanning, malicious traffic, or misconfigured clients — this eliminates expensive exception handling overhead and improves throughput by up to 20-40%. There's no impact on valid request processing.
4+
5+
The HTTP logging middleware now pools its `ResponseBufferingStream` instances, reducing per-request allocations when response body logging or interceptors are enabled.

0 commit comments

Comments
 (0)