Bermigrasi dari .NET Framework 1.1

Windows 7 dan versi yang lebih baru dari sistem operasi Windows tidak mendukung .NET Framework 1.1. Akibatnya, aplikasi yang menargetkan .NET Framework 1.1 tidak akan berjalan tanpa modifikasi pada Windows 7 atau versi sistem operasi yang lebih baru. Topik ini membahas langkah-langkah yang diperlukan untuk menjalankan aplikasi yang menargetkan .NET Framework 1.1 di bawah Windows 7 dan versi yang lebih baru dari sistem operasi Windows. Untuk informasi selengkapnya tentang .NET Framework 1.1 dan Windows 8, lihat Menjalankan Aplikasi .NET Framework 1.1 di Windows 8 dan versi yang lebih baru.

Penargetan ulang atau kompilasi ulang

Ada dua cara untuk mendapatkan aplikasi yang dikompilasi menggunakan .NET Framework 1.1 untuk berjalan pada sistem operasi Windows 7 atau Windows yang lebih baru:

• Menargetkan ulang aplikasi untuk dijalankan di bawah .NET Framework 4 dan versi yang lebih baru. Menargetkan ulang mengharuskan Anda menambahkan elemen <supportedRuntime> ke file konfigurasi aplikasi yang memungkinkannya berjalan di bawah .NET Framework 4 dan versi yang lebih baru. File konfigurasi semacam itu mengambil formulir berikut:

  <configuration>
     <startup>
        <supportedRuntime version="v4.0"/>
     </startup>
  </configuration>
  

• Mengompilasi ulang aplikasi dengan kompilator yang menargetkan .NET Framework 4 atau versi yang lebih baru. Jika Anda awalnya menggunakan Visual Studio 2003 untuk mengembangkan dan mengompilasi solusi Anda, Anda dapat membuka solusi di Visual Studio 2010 (dan mungkin versi yang lebih baru juga) dan menggunakan kotak dialog Kompatibilitas Proyek untuk mengonversi solusi dan file proyek dari format yang digunakan oleh Visual Studio 2003 ke format Microsoft Build Engine (MSBuild).

Terlepas dari apakah Anda lebih suka mengompilasi ulang atau menargetkan ulang aplikasi, Anda harus menentukan apakah aplikasi Anda terpengaruh oleh perubahan apa pun yang diperkenalkan dalam versi .NET Framework yang lebih baru. Perubahan ini terdiri dari dua jenis:

• Melanggar perubahan yang terjadi antara versi .NET Framework 1.1 dan yang lebih baru dari .NET Framework.

• Jenis dan jenis anggota yang telah ditandai sebagai tidak digunakan lagi atau usang antara versi .NET Framework 1.1 dan yang lebih baru dari .NET Framework.

Baik Anda menargetkan ulang aplikasi atau mengompilasi ulang aplikasi, Anda harus meninjau perubahan yang melanggar dan jenis dan anggota usang untuk setiap versi .NET Framework yang dirilis setelah .NET Framework 1.1.

Perubahan mencolok

Ketika perubahan yang melanggar terjadi, bergantung pada perubahan tertentu, solusi mungkin tersedia baik untuk aplikasi yang ditargetkan ulang dan dikompilasi ulang. Dalam beberapa kasus, Anda dapat menambahkan elemen turunan ke elemen <runtime bahasa umum> file konfigurasi aplikasi Anda untuk memulihkan perilaku sebelumnya. Misalnya, file konfigurasi berikut memulihkan pengurutan string dan perilaku perbandingan yang digunakan dalam .NET Framework 1.1 dan dapat digunakan baik dengan aplikasi yang ditargetkan ulang atau dikompilasi ulang.

<configuration>
   <runtime>
      <CompatSortNLSVersion enabled="4096"/>
   </runtime>
</configuration>

Namun, dalam beberapa kasus, Anda mungkin harus memodifikasi kode sumber dan mengompilasi ulang aplikasi Anda.

Untuk menilai dampak kemungkinan perubahan yang melanggar pada aplikasi Anda, Anda harus meninjau daftar perubahan berikut:

• Melanggar Perubahan di .NET Framework 2.0 dokumen berubah di .NET Framework 2.0 SP1 yang dapat memengaruhi aplikasi yang menargetkan .NET Framework 1.1.

• Perubahan di .NET Framework 3.5 SP1 dokumen berubah antara .NET Framework 3.5 dan .NET Framework 3.5 SP1.

• Masalah Migrasi .NET Framework 4 dokumen berubah antara .NET Framework 3.5 SP1 dan .NET Framework 4.

Jenis dan anggota yang lama

Dampak dari jenis dan anggota yang tidak digunakan lagi agak berbeda untuk aplikasi yang ditargetkan ulang dan aplikasi yang dikompilasi ulang. Penggunaan jenis dan anggota yang lama tidak akan memengaruhi aplikasi yang ditargetkan ulang kecuali jenis atau anggota yang sudah usang telah dihapus secara fisik dari rakitannya. Mengompilasi ulang aplikasi yang menggunakan jenis atau anggota usang biasanya menghasilkan peringatan kompilator daripada kesalahan kompilator. Namun, dalam beberapa kasus, ini menghasilkan kesalahan kompilator, dan kode yang menggunakan jenis usang atau anggota tidak berhasil dikompilasi. Dalam hal ini, Anda harus menulis ulang kode sumber yang memanggil jenis atau anggota usang sebelum mengompilasi ulang aplikasi Anda. Untuk informasi selengkapnya tentang jenis dan anggota yang usang, lihat Apa yang Usang di Pustaka Kelas.

Untuk menilai dampak jenis dan anggota yang tidak digunakan lagi sejak rilis .NET Framework 2.0 SP1, lihat Apa yang Usang di Pustaka Kelas. Tinjau daftar jenis dan anggota usang untuk .NET Framework 2.0 SP1, .NET Framework 3.5, dan .NET Framework 4.