Perubahan signifikan di .NET 11

Jika Anda memigrasikan aplikasi ke .NET 11, perubahan mencolok yang tercantum di sini mungkin memengaruhi Anda. Perubahan dikelompokkan menurut area teknologi, seperti ASP.NET Core atau Formulir Windows.

Artikel ini mengategorikan setiap perubahan signifikan sebagai tidak kompatibel secara biner atau tidak kompatibel secara sumber, atau perubahan perilaku:

  • Biner tidak kompatibel - Saat dijalankan terhadap runtime atau komponen baru, biner yang ada mungkin mengalami perubahan perilaku yang melanggar, seperti kegagalan memuat atau mengeksekusi, dan jika demikian, memerlukan kompilasi ulang.

  • Sumber tidak kompatibel - Saat dikompilasi ulang menggunakan SDK atau komponen baru atau untuk menargetkan runtime baru, kode sumber yang ada mungkin memerlukan perubahan sumber agar berhasil dikompilasi.

  • Perubahan perilaku - Kode dan biner yang ada mungkin berperilaku berbeda saat runtime. Jika perilaku baru tidak diinginkan, kode yang ada perlu diperbarui dan dikompilasi ulang.

Nota

Artikel ini sedang dalam dikerjakan. Ini bukan daftar lengkap perubahan pemutusan di .NET 11.

ASP.NET Core

Lihat Perubahan yang dapat menyebabkan gangguan di ASP.NET Core 11.

Pustaka .NET inti

Judul Jenis perubahan
Perilaku Assembly.GetCallingAssembly berubah saat dukungan pelacakan tumpukan dinonaktifkan Perubahan perilaku
CborReader dan CborWriter menerapkan kedalaman penyarangan maksimum bawaan Perubahan perilaku
Hasil bilangan kompleks dengan nilai spesial kini mengikuti Lampiran G C23 Perubahan perilaku
Validasi CRC32 ditambahkan saat membaca entri arsip ZIP Perubahan perilaku
Metode DateOnly dan TimeOnly TryParse menghasilkan kesalahan untuk masukan yang tidak valid Perubahan perilaku
Konversi bilangan titik mengambang Decimal dan BigInteger dibulatkan dengan benar Perubahan perilaku
DeflateStream dan GZipStream menulis header dan footer untuk payload kosong Perubahan perilaku
Environment.TickCount dibuat konsisten dengan perilaku batas waktu Windows Perubahan perilaku
Math.Round dan MathF.Round mengembalikan hasil yang dibulatkan dengan benar Perubahan perilaku
NamedPipeServerStream dengan PipeOptions.CurrentUserOnly memperketat izin file soket Unix Perubahan perilaku
Nullable.GetUnderlyingType melempar untuk subkelas Tipe kustom Perubahan perilaku
PackagePart.GetStream() mengembalikan aliran yang tidak dapat dicari untuk bagian terkompresi dalam paket ReadWrite Perubahan perilaku
Penghentian API dengan ID diagnostik non-default (.NET 11) Sumber tidak kompatibel
SafeFileHandle.IsAsync dan FileStream.IsAsync secara akurat mencerminkan status non-pemblokiran pada Unix Perubahan perilaku
API pembacaan TAR memverifikasi checksum header saat membaca Perubahan perilaku
TarWriter menggunakan entri HardLink untuk file yang ditautkan secara permanen Perubahan perilaku
ZipArchive.CreateAsync dengan bersemangat memuat entri arsip ZIP Perubahan perilaku

Cryptography

Judul Jenis perubahan
Kedaluwarsa API Sumber tidak kompatibel
ML-DSA komposit pada Windows menggunakan implementasi asli Perubahan perilaku
DSA dihapus dari macOS Perubahan perilaku
Pengambilan sertifikat AIA di Linux dibatasi hingga dua kali pengambilan per pembuatan rantai Perubahan perilaku

Penyebaran

Judul Jenis perubahan
configProperties dalam .runtimeconfig.dev.json mengambil alih .runtimeconfig.json Perubahan perilaku

Ekstensi

Judul Jenis perubahan
ChangeToken.OnChange async overloads mengikat kembali panggilan balik yang dikembalikan Tugas yang ada Perubahan perilaku
FileConfigurationProvider tidak menaikkan token muat ulang setelah kegagalan pemuatan yang diabaikan Perubahan perilaku
Callback FileConfigurationSource.OnLoadException dipanggil saat terjadi error I/O Perubahan perilaku
IHost.RunAsync dan IHost.StopAsync melempar ketika BackgroundService gagal Perubahan perilaku
Beberapa paket Microsoft.Extensions disertakan dalam kerangka kerja bersama Perubahan perilaku

Globalization

Judul Jenis perubahan
Tanggal minimum Kalender Jepang yang didukung diperbaik Perubahan perilaku

Interop

Judul Jenis perubahan
NativeAOT menggunakan awalan lib untuk output pustaka asli di Unix Perubahan perilaku

JIT compiler

Judul Jenis perubahan
Persyaratan perangkat keras minimum diperbarui Perubahan perilaku

Jaringan

Judul Jenis perubahan
Unduhan sertifikat AIA sisi server SslStream dinonaktifkan secara default Perubahan perilaku

.NET MAUI

Judul Jenis perubahan
Tingkat API Android minimum dinaikkan ke 24 Perubahan perilaku

SDK dan MSBuild

Judul Jenis perubahan
skrip dnx mengabaikan pemilihan SDK di global.json Perubahan perilaku
Target peluncuran mono tidak ditetapkan untuk aplikasi .NET Framework Perubahan perilaku
Penanganan perintah NativeAOT CLI diaktifkan secara default Perubahan perilaku
NU1703 memperingatkan untuk paket yang menggunakan aset kerangka kerja MonoAndroid yang tidak digunakan lagi Sumber tidak kompatibel
NuGet pack memberikan peringatan untuk ID paket dengan karakter yang dibatasi Perubahan perilaku
Pemilihan runtime kontainer lokal SDK mengutamakan alat bawaan platform Perubahan perilaku
Paket mesin templat tidak lagi mendukung netstandard2.0 Biner/sumber tidak kompatibel
VSTest menghapus dependensi pada Newtonsoft.Json Biner/sumber tidak kompatibel