Perubahan yang melanggar mungkin terjadi saat porting kode

Perubahan yang memengaruhi kompatibilitas, yang juga dikenal sebagai perubahan besar yang dapat menyebabkan ketidakcocokan, terkadang terjadi antarversi .NET. Perubahan berdampak saat porting dari .NET Framework ke .NET karena teknologi tertentu tidak tersedia. Selain itu, Anda mungkin menemui perubahan yang menyebabkan inkompatibilitas hanya karena .NET adalah teknologi lintas platform, sedangkan .NET Framework bukan.

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 yang dapat menyebabkan inkompatibilitas ini, lihat Perubahan yang dapat menyebabkan inkompatibilitas untuk migrasi dari .NET Framework ke .NET.