Dapat terjadi perubahan signifikan saat memindahkan kode

Perubahan yang memengaruhi kompatibilitas, atau dikenal sebagai perubahan yang memutuskan kompatibilitas, akan terjadi antar versi .NET. Perubahan berdampak saat porting dari .NET Framework ke .NET karena teknologi tertentu tidak tersedia. Selain itu, Anda dapat menemukan perubahan yang melanggar hanya karena .NET adalah teknologi lintas platform dan .NET Framework tidak.

Microsoft berusaha mempertahankan tingkat kompatibilitas yang tinggi antara versi .NET; meskipun perubahan mendasar memang terjadi, perubahan tersebut dipertimbangkan dengan hati-hati.

Sebelum memutakhirkan versi utama, periksa dokumentasi perubahan yang mengganggu untuk perubahan yang mungkin memengaruhi Anda.

Perubahan yang memengaruhi kompatibilitas

Ada beberapa jenis perubahan yang dapat dilakukan penulis pustaka yang memengaruhi kompatibilitas, termasuk:

• Modifikasi pada kontrak publik
• Perubahan perilaku
• Dukungan platform
• Perubahan implementasi internal
• Perubahan kode

Untuk informasi selengkapnya tentang jenis perubahan apa yang diizinkan atau tidak diizinkan, lihat Mengubah aturan untuk kompatibilitas.

Jenis kompatibilitas

Kompatibilitas mengacu pada kemampuan untuk mengkompilasi atau menjalankan kode pada implementasi .NET selain yang kodenya awalnya dikembangkan.

Ada enam cara berbeda yang dapat memengaruhi kompatibilitas:

• Perubahan perilaku
• Kompatibilitas biner
• Kompatibilitas sumber
• Kompatibilitas saat desain
• Kompatibilitas mundur
• Kompatibilitas ke depan

Untuk informasi selengkapnya, lihat Bagaimana perubahan kode dapat memengaruhi kompatibilitas.

Menemukan perubahan yang merusak

Perubahan yang memengaruhi kompatibilitas didokumenkan. Tinjau perubahan ini sebelum Anda mem-port kode Anda dari .NET Framework ke .NET atau tingkatkan ke versi .NET yang lebih baru. Untuk daftar perubahan signifikan ini, lihat Perubahan signifikan untuk migrasi dari .NET Framework ke .NET Core.