Prasyarat untuk memindahkan kode

Buat perubahan yang diperlukan untuk membangun dan menjalankan aplikasi .NET sebelum memulai pekerjaan untuk memindahkan kode Anda. Perubahan ini dapat dilakukan saat masih membangun dan menjalankan aplikasi .NET Framework.

Penting

Asisten Peningkatan .NET secara resmi tidak digunakan lagi. Gunakan agen obrolan modernisasi GitHub Copilot sebagai gantinya, yang disertakan dengan Visual Studio 2026 dan Visual Studio 2022 17.14.16 atau yang lebih baru. Agen ini menganalisis proyek dan dependensi Anda, menghasilkan rencana migrasi langkah demi langkah dengan rekomendasi yang ditargetkan dan perbaikan kode otomatis, dan menerapkan setiap perubahan sehingga Anda dapat memvalidasi atau mengembalikan. Ini mengotomatiskan tugas porting umum—memperbarui file proyek, mengganti API yang tidak digunakan lagi, dan menyelesaikan masalah build—sehingga Anda dapat memodernisasi lebih cepat dengan lebih sedikit upaya manual.

Perbarui alat ke versi yang diperlukan

Tingkatkan ke versi MSBuild/Visual Studio yang mendukung versi .NET yang akan Anda targetkan. Lihat Hubungan penerapan versi antara .NET SDK, MSBuild, dan VS untuk informasi selengkapnya.

Memperbarui versi target .NET Framework

Kami menyarankan agar Anda menargetkan aplikasi .NET Framework Anda ke versi 4.7.2 atau yang lebih tinggi. Ini memastikan ketersediaan alternatif API terbaru untuk kasus di mana .NET Standard tidak mendukung API yang ada.

Untuk setiap proyek yang ingin Anda porting, lakukan hal berikut di Visual Studio:

1. Klik kanan pada proyek dan pilih Properti.
2. Di menu dropdown Kerangka Kerja Target , pilih .NET Framework 4.7.2.
3. Kompilasi ulang proyek.

Karena proyek Anda sekarang menargetkan .NET Framework 4.7.2, gunakan versi .NET Framework tersebut sebagai basis Anda untuk kode porting.

Ubah ke format PackageReference

Konversikan semua referensi ke format PackageReference .

Mengonversi ke format proyek gaya SDK

Konversikan proyek Anda ke format gaya SDK.

Memperbarui dependensi

Perbarui dependensi ke versi terbarunya yang tersedia, dan ke versi .NET Standard jika memungkinkan.

Langkah selanjutnya

• Membuat rencana porting