Skip to content

Correct .NET 11 RC1 libraries release notes - #10570

Open
danroth27 wants to merge 1 commit into
mainfrom
release-notes/11.0-rc1-libraries-cleanup
Open

Correct .NET 11 RC1 libraries release notes#10570
danroth27 wants to merge 1 commit into
mainfrom
release-notes/11.0-rc1-libraries-cleanup

Conversation

@danroth27

Copy link
Copy Markdown
Member

Summary

  • remove numeric conversion breaking-change notes that already shipped and were documented in .NET 11 Preview 7
  • correct the AES-KWP attribution from .NET 11 to .NET 10
  • remove the obsolete preview language-version directive from the C# 15 JSON union sample
  • add a runnable AES Key Wrap example

Validation

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
using Aes aes = Aes.Create();
aes.Key = RandomNumberGenerator.GetBytes(32);

Starting in .NET 11 Preview 7, conversions between `decimal` and binary floating-point types, and conversions from `BigInteger` to binary floating-point types, round the exact source value once to the nearest representable destination value ([dotnet/runtime #130565](https://github.com/dotnet/runtime/pull/130565), [dotnet/runtime #130566](https://github.com/dotnet/runtime/pull/130566)). The previous conversions could lose significant digits or round through an intermediate value, so existing binaries and code rebuilt with a .NET 11 Preview 7 or later SDK can produce different results.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We missed catching this breaking change note in the Preview 7 release notes as we didn't document it until RC1.

#10542 (comment)

Please check with @tannergooding before removing this per their comment linked there, and I too thought it was a pretty noteworthy thing to cover, albeit late.

## AES Key Wrap support

The `Aes` class now supports the unpadded AES Key Wrap algorithm defined by RFC 3394 ([dotnet/runtime #132477](https://github.com/dotnet/runtime/pull/132477)). The new `EncryptKeyWrap`, `DecryptKeyWrap`, `TryDecryptKeyWrap`, and `GetKeyWrapLength` methods complement the padded AES-KWP APIs added earlier in .NET 11.
The `Aes` class now supports the unpadded AES Key Wrap algorithm defined by RFC 3394 ([dotnet/runtime #132477](https://github.com/dotnet/runtime/pull/132477)). The new `EncryptKeyWrap`, `DecryptKeyWrap`, `TryDecryptKeyWrap`, and `GetKeyWrapLength` methods complement the padded AES-KWP APIs added in .NET 10.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This change is correct; thanks. dotnet/runtime#130490

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants