Cara: Mengonfigurasi Aplikasi untuk Mendukung .NET Framework 4 atau versi yang lebih baru

  • Artikel

Semua aplikasi yang menghosting runtime bahasa umum (CLR) harus memulai, atau mengaktifkan, CLR untuk menjalankan kode terkelola. Biasanya, aplikasi .NET Framework berjalan pada versi CLR yang digunakan untuk membuatnya, tetapi Anda dapat mengubah perilaku ini untuk aplikasi desktop dengan menggunakan file konfigurasi aplikasi (terkadang disebut sebagai file app.config). Namun, Anda tidak dapat mengubah perilaku aktivasi default untuk aplikasi Windows Store atau aplikasi Windows Phone dengan menggunakan file konfigurasi aplikasi. Artikel ini menjelaskan cara mengaktifkan aplikasi desktop Anda agar berjalan di versi lain .NET Framework dan memberikan contoh cara menargetkan versi 4 atau versi yang lebih baru.

Versi .NET Framework yang menjalankan aplikasi ditentukan dalam urutan berikut:

  • File konfigurasi.

    Jika file konfigurasi aplikasi menyertakan entri <supportedRuntime> yang menentukan satu atau beberapa versi .NET Framework, dan salah satu versi tersebut ada di komputer pengguna, aplikasi akan berjalan pada versi tersebut. File konfigurasi membaca entri <supportedRuntime> dalam urutan yang tercantum, dan menggunakan versi .NET Framework pertama yang terdaftar yang ada di komputer pengguna. (Gunakan elemen <requiredRuntime> untuk versi 1.0.)

  • Versi yang dikompilasi.

    Jika tidak ada file konfigurasi, tetapi versi .NET Framework tempat aplikasi dibuat ada di komputer pengguna, aplikasi akan berjalan pada versi tersebut.

  • Versi terbaru diinstal.

    Jika versi .NET Framework tempat aplikasi dibuat tidak ada dan file konfigurasi tidak menentukan versi dalam elemen <supportedRuntime>, aplikasi akan mencoba berjalan di versi terbaru .NET Framework yang ada di komputer pengguna.

    Namun, aplikasi .NET Framework 1.0, 1.1, 2.0, 3.0, dan 3.5 tidak berjalan secara otomatis pada .NET Framework 4 atau yang lebih baru, dan dalam beberapa kasus, pengguna mungkin menerima kesalahan dan mungkin diminta untuk menginstal .NET Framework 3.5. Perilaku aktivasi mungkin juga bergantung pada sistem operasi pengguna, karena versi sistem Windows yang berbeda menyertakan versi .NET Framework yang berbeda. Jika aplikasi Anda mendukung .NET Framework 3.5 dan 4 atau yang lebih baru, sebaiknya Anda menunjukkan ini dengan beberapa entri dalam file konfigurasi untuk menghindari kesalahan inisialisasi .NET Framework. Untuk informasi selengkapnya, lihat Versi dan Dependensi.

Anda mungkin juga ingin mengonfigurasi aplikasi .NET Framework 3.5 agar berjalan di .NET Framework 4 atau versi yang lebih baru, bahkan di komputer yang menginstal .NET Framework 3.5, untuk memanfaatkan peningkatan performa di versi 4 dan versi yang lebih baru.

Penting

Sebaiknya Anda selalu menguji aplikasi pada setiap versi .NET Framework yang Anda dukung. Lihat Kompatibilitas Versi untuk informasi tentang meningkatkan aplikasi Anda untuk mendukung versi .NET Framework yang lebih baru.

Untuk informasi tentang memodifikasi aplikasi .NET Framework 1.0 dan 1.1 Anda agar mendukung Windows 7 dan Windows 8, lihat Migrasi dari .NET Framework 1.1.

Untuk mengonfigurasi aplikasi Anda agar berjalan di .NET Framework 4 atau versi yang lebih baru

  1. Tambahkan atau temukan file konfigurasi untuk proyek .NET Framework. File konfigurasi untuk aplikasi berada di direktori yang sama dan memiliki nama yang sama dengan aplikasi, tetapi memiliki ekstensi .config. Misalnya, untuk aplikasi bernama MyExecutable.exe, file konfigurasi aplikasi bernama MyExecutable.exe.config.

    Untuk menambahkan file konfigurasi, pada bilah menu Visual Studio, pilih Proyek, Tambahkan Item Baru. Pilih Umum dari panel kiri, lalu pilih File Konfigurasi. Beri nama file konfigurasi App.config. Pilihan menu ini tidak tersedia untuk aplikasi Windows Store atau proyek aplikasi Windows phone, karena Anda tidak dapat mengubah kebijakan aktivasi pada platform tersebut.

  2. Tambahkan elemen <supportedRuntime> sebagai berikut ke file konfigurasi aplikasi:

    <configuration>
  <startup>
    <supportedRuntime version="version"/>
  </startup>
</configuration>

    di mana <versi> menentukan versi CLR yang sesuai dengan versi .NET Framework yang didukung aplikasi Anda. Gunakan string berikut:

    • .NET Framework 1.0: "v1.0.3705"

    • .NET Framework 1.1: "v1.1.4322"

    • .NET Framework 2.0, 3.0, dan 3.5: "v2.0.50727"

    • .NET Framework 4 dan versi yang lebih baru: "v4.0"

    Anda dapat menambahkan beberapa elemen <supportedRuntime>, tercantum dalam urutan preferensi, untuk menentukan dukungan bagi beberapa versi .NET Framework.

Tabel berikut menunjukkan bagaimana pengaturan file konfigurasi aplikasi dan versi .NET Framework yang diinstal di komputer menentukan versi yang menjalankan aplikasi .NET Framework 3.5. Contoh ini khusus untuk aplikasi .NET Framework 3.5, tetapi Anda dapat menggunakan logika yang serupa untuk menargetkan aplikasi yang dibuat dengan versi .NET Framework yang lebih lama. Perhatikan bahwa nomor versi .NET Framework 2.0 (v2.0.50727) digunakan untuk menentukan .NET Framework 3.5 dalam file konfigurasi aplikasi.

Pengaturan file App.config Di komputer dengan versi 3.5 terinstal Di komputer dengan versi 3.5 dan 4 atau versi yang lebih baru diinstal Di komputer dengan versi 4 atau versi yang lebih baru diinstal
Tidak Berjalan pada versi 3.5 Berjalan pada versi 3.5 Menampilkan pesan kesalahan yang meminta pengguna untuk menginstal versi yang true*
<supportedRuntime version="v2.0.50727"/> Berjalan pada versi 3.5 Berjalan pada versi 3.5 Menampilkan pesan kesalahan yang meminta pengguna untuk menginstal versi yang true*
<supportedRuntime version="v2.0.50727"/>
<supportedRuntime version="v4.0"/>		 Berjalan pada versi 3.5 Berjalan pada versi 3.5 Berjalan pada versi 4 atau versi yang lebih baru
<supportedRuntime version="v4.0"/>
<supportedRuntime version="v2.0.50727"/>		 Berjalan pada versi 3.5 Berjalan pada versi 4 atau versi yang lebih baru Berjalan pada versi 4 atau versi yang lebih baru
<supportedRuntime version="v4.0"/> Menampilkan pesan kesalahan yang meminta pengguna untuk menginstal versi yang true* Berjalan pada versi 4 atau versi yang lebih baru Berjalan pada versi 4 atau versi yang lebih baru

* Untuk informasi selengkapnya tentang pesan kesalahan ini dan cara menghindarinya, lihat Kesalahan Inisialisasi .NET Framework: Mengelola Pengalaman Pengguna.

Lihat juga