Mulai menggunakan ASP.NET inkremental untuk ASP.NET migrasi Core

Untuk migrasi besar, sebaiknya siapkan aplikasi ASP.NET Core yang proksi ke aplikasi .NET Framework asli. Aplikasi proksi baru yang diaktifkan ditampilkan dalam gambar berikut:

Untuk memahami bagaimana pendekatan ini berguna dalam proses migrasi, lihat Migrasi inkremental ASP.NET ke ASP.NET Core. Artikel rest ini menyediakan langkah-langkah untuk melanjutkan migrasi bertahap.

Menyiapkan ASP.NET Core Project

Untuk ASP.NET aplikasi MVC dan Web API, lihat Pelajari cara meningkatkan dari ASP.NET MVC dan Api Web ke ASP.NET Core MVC. Untuk aplikasi ASP.NET Framework Web Forms, lihat Pelajari cara meningkatkan dari ASP.NET Web Forms ke ASP.NET Core.

Meningkatkan pustaka pendukung

Jika Anda memiliki pustaka pendukung dalam solusi yang perlu Anda gunakan, pustaka tersebut harus ditingkatkan ke .NET Standard 2.0, jika memungkinkan. Asisten Peningkatan adalah alat yang bagus untuk ini. Jika pustaka tidak dapat menargetkan .NET Standard, Anda dapat menargetkan .NET 6 atau yang lebih baru baik bersama dengan target .NET Framework dalam proyek asli atau di proyek baru bersama yang asli.

Adaptor dapat digunakan dalam pustaka ini untuk mengaktifkan dukungan untuk System.Web.HttpContext penggunaan di pustaka kelas. Untuk mengaktifkan System.Web.HttpContext penggunaan di pustaka:

1. Hapus referensi ke System.Web dalam file proyek
2. Microsoft.AspNetCore.SystemWebAdapters Menambahkan paket
3. Aktifkan multi-penargetan dan tambahkan target .NET 6 atau yang lebih baru, atau konversi proyek ke .NET Standard 2.0.
4. Pastikan kerangka kerja target mendukung .NET Core. Multi-penargetan dapat digunakan jika .NET Standard 2.0 tidak cukup

Langkah ini mungkin memerlukan sejumlah proyek untuk berubah tergantung pada struktur solusi Anda. Asisten Peningkatan dapat membantu Anda mengidentifikasi mana yang perlu diubah dan mengotomatiskan sejumlah langkah dalam proses.

Aktifkan Dukungan Sesi

Sesi adalah fitur ASP.NET yang umum digunakan yang berbagi nama dengan fitur di ASP.NET Core API jauh berbeda. Lihat dokumentasi tentang dukungan sesi.

Mengaktifkan dukungan autentikasi bersama

Dimungkinkan untuk berbagi autentikasi antara aplikasi ASP.NET asli dan aplikasi ASP.NET Core baru dengan menggunakan System.Web fitur autentikasi jarak jauh adaptor. Fitur ini memungkinkan aplikasi ASP.NET Core untuk menungguhkan autentikasi ke aplikasi ASP.NET. Lihat koneksi aplikasi jarak jauh dan dokumen autentikasi jarak jauh untuk detail selengkapnya.

Panduan Penggunaan Umum

Ada sejumlah perbedaan antara ASP.NET dan ASP.NET Core yang dapat membantu diperbarui oleh adaptor. Namun, ada beberapa fitur yang memerlukan keikutsertaan karena dikenakan beberapa biaya. Ada juga perilaku yang tidak dapat diadaptasi. Lihat panduan penggunaan untuk daftar ini.