Baca dalam bahasa Inggris

Bagikan melalui


Memutus perubahan di .NET 9

Jika Anda memigrasikan aplikasi ke .NET 9, perubahan melanggar yang tercantum di sini dapat memengaruhi Anda. Perubahan dikelompokkan berdasarkan bidang teknologi, seperti ASP.NET Core atau Formulir Windows.

Artikel ini mengategorikan setiap perubahan yang melanggar karena biner tidak kompatibel atau sumber tidak kompatibel, atau sebagai 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 pada waktu proses. Jika perilaku baru tidak diinginkan, kode yang ada perlu diperbarui dan dikompilasi ulang.

Catatan

Artikel ini sedang dalam dikerjakan. Ini bukan daftar lengkap perubahan yang melanggar di .NET 9. Untuk mengkueri perubahan yang mencolok yang masih menunggu publikasi, lihat Masalah .NET.

Inti ASP.NET

Kontainer

Judul Jenis perubahan Versi yang diperkenalkan
Gambar kontainer tidak lagi menginstal zlib Perubahan perilaku Pratinjau 7
gambar .NET Monitor disederhanakan ke tag khusus versi Perubahan perilaku Pratinjau 5

Pustaka .NET Inti

Judul Jenis perubahan Versi yang diperkenalkan
Menambahkan ZipArchiveEntry dengan CompressionLevel mengatur bendera bit tujuan umum header direktori pusat ZIP Perubahan perilaku Pratinjau 5
Dukungan UnsafeAccessor yang diubah untuk generik non-terbuka Perubahan perilaku Pratinjau 6
KEDALUARSA API dengan ID diagnostik kustom Sumber tidak kompatibel (Beberapa)
Panjang maksimum BigInteger Perubahan perilaku Pratinjau 6
BinaryReader.GetString() mengembalikan "\uFFFD" pada urutan cacat Perubahan perilaku Pratinjau 7
Membuat jenis array System.Void tidak diperbolehkan Perubahan perilaku Pratinjau 1
Default Equals() dan GetHashCode() lempar untuk jenis yang ditandai dengan InlineArrayAttribute Perubahan perilaku Pratinjau 6
EnumConverter memvalidasi jenis terdaftar untuk dienum Perubahan perilaku Pratinjau 7
FromKeyedServicesAttribute tidak lagi menyuntikkan parameter non-kunci Perubahan perilaku RC 1
Panggilan balik awal IncrementingPollingCounter tidak sinkron Perubahan perilaku RC 1
Batas ukuran struct array sebaris diberlakukan Perubahan perilaku Pratinjau 1
InMemoryDirectoryInfo menambahkan rootDir ke file Perubahan perilaku Pratinjau 1
TimeSpan Baru.From*() kelebihan beban yang mengambil bilangan bulat Sumber tidak kompatibel Pratinjau 3
Versi baru dari beberapa paket OOB Sumber tidak kompatibel Pratinjau 5
RuntimeHelpers.GetSubArray mengembalikan jenis yang berbeda Perubahan perilaku Pratinjau 1
String.Trim(params ReadOnlySpan<char) overload> dihapus Sumber/biner tidak kompatibel GA
Dukungan untuk variabel lingkungan kosong Perubahan perilaku Pratinjau 6
Nama dan komentar ZipArchiveEntry menghormati bendera UTF8 Perubahan perilaku RC 1

Kriptografi

Judul Jenis perubahan Versi yang diperkenalkan
SafeEvpPKeyHandle.DuplicateHandle meningkatkan handel Perubahan perilaku Pratinjau 7
Beberapa konstruktor X509Certificate2 dan X509Certificate sudah usang Sumber tidak kompatibel Pratinjau 7
Masa pakai kunci privat Windows disederhanakan Perubahan perilaku Pratinjau 7

Penyebaran

Judul Jenis perubahan Versi yang diperkenalkan
Paket runtime Windows/macOS/Linux MonoVM desktop yang tidak digunakan lagi Sumber tidak kompatibel Pratinjau 7

Interop

Judul Jenis perubahan Versi yang diperkenalkan
CET didukung secara default Biner tidak kompatibel Pratinjau 6

Kompilator JIT

Judul Jenis perubahan Versi yang diperkenalkan
Konversi titik mengambang ke bilangan bulat menjenuhkan Perubahan perilaku Pratinjau 4
Beberapa API SVE dihapus Sumber tidak kompatibel RC 2

Jaringan

Judul Jenis perubahan Versi yang diperkenalkan
KEDALUARSA API Sumber tidak kompatibel Pratinjau 6
Laporan server.port metrik HttpClient tanpa syarat Perubahan perilaku Pratinjau 7
Pengelogan HttpClientFactory meredaksi nilai header secara default Perubahan perilaku RC 1
HttpClientFactory menggunakan SocketsHttpHandler sebagai handler utama Perubahan perilaku Pratinjau 6
HttpListenerRequest.UserAgent dapat diubah ke null Sumber tidak kompatibel Pratinjau 1
Redaksi kueri URI dalam peristiwa HttpClient EventSource Perubahan perilaku Pratinjau 7
Redaksi kueri URI di log IHttpClientFactory Perubahan perilaku Pratinjau 7

SDK dan MSBuild

Judul Jenis perubahan Versi yang diperkenalkan
dotnet restore mengaudit paket transitif Perubahan perilaku Pratinjau 6
dotnet watch tidak kompatibel dengan Hot Reload untuk kerangka kerja lama Perubahan perilaku RC 1
dotnet workload perubahan output perintah Perubahan perilaku Pratinjau 1
installer versi repo tidak lagi didokumenkan Perubahan perilaku Pratinjau 5
Pencatat terminal adalah default Perubahan perilaku Pratinjau 1
Persyaratan versi untuk .NET 9 SDK Sumber tidak kompatibel GA
Peringatan yang dipancarkan untuk target .NET Standard 1.x Sumber tidak kompatibel Pratinjau 6
Peringatan yang dipancarkan untuk target .NET 7 Sumber tidak kompatibel GA

Serialisasi

Judul Jenis perubahan Versi yang diperkenalkan
BinaryFormatter selalu melempar Perubahan perilaku Pratinjau 6
Atribut Nullable JsonDocument didesserialisasi ke JsonValueKind.Null Perubahan perilaku Pratinjau 1

Formulir Windows

Judul Jenis perubahan Versi yang diperkenalkan
BindingSource.SortDescriptions tidak mengembalikan null Perubahan perilaku Pratinjau 1
Perubahan pada anotasi nullability Sumber tidak kompatibel Pratinjau 1
ComponentDesigner.Initialize melempar ArgumenNullException Perubahan perilaku Pratinjau 1
DataGridViewRowAccessibleObject.Name indeks baris awal Perubahan perilaku Pratinjau 1
Dukungan IMsoComponent adalah keikutsertaan Perubahan perilaku Pratinjau 2
Penganalisis keamanan baru Sumber tidak kompatibel RC 1
Tidak terkecuali jika DataGridView null Perubahan perilaku Pratinjau 1
PictureBox menaikkan pengecualian HttpClient Perubahan perilaku Pratinjau 6

WPF

Judul Jenis perubahan Versi yang diperkenalkan
GetXmlNamespaceMaps perubahan jenis Perubahan perilaku/Sumber tidak kompatibel Pratinjau 3

Lihat juga