Bagikan melalui

<supportedRuntime> elemen

Menentukan versi runtime bahasa umum mana dan, secara opsional, versi .NET Framework yang didukung aplikasi.

<configuration>   <startup>     <supportedRuntime>

Syntax

<supportedRuntime version="runtime version" sku="SKU ID"/>

Attributes

Attribute Description
version Atribut opsional.

Nilai string yang menentukan versi runtime bahasa umum (CLR) yang didukung aplikasi ini. Untuk nilai atribut yang version valid, lihat bagian nilai "versi runtime" . Nota: Melalui .NET Framework 3.5, nilai "versi runtime" mengambil formulir utama. kecil. build. Dimulai dengan .NET Framework 4, hanya nomor versi utama dan minor yang diperlukan (yaitu, "v4.0" alih-alih "v4.0.30319"). String yang lebih pendek disarankan.
Sku Atribut opsional.

Nilai string yang menentukan unit penyimpanan stok (SKU), yang pada gilirannya menentukan rilis .NET Framework mana yang didukung aplikasi ini.

Dimulai dengan .NET Framework 4.0, penggunaan sku atribut disarankan. Saat ada, ini menunjukkan versi .NET Framework yang ditargetkan aplikasi.

Untuk nilai atribut yang sku valid, lihat bagian nilai "ID SKU" .

Komentar

<supportedRuntime> Jika elemen tidak ada dalam file konfigurasi aplikasi, versi runtime yang digunakan untuk membangun aplikasi akan digunakan.

Elemen <supportedRuntime> harus digunakan oleh semua aplikasi yang dibangun menggunakan versi 1.1 atau yang lebih baru dari runtime. Aplikasi yang dibuat untuk hanya mendukung runtime versi 1.0 harus menggunakan <elemen requiredRuntime> .

Nota

Jika Anda menggunakan fungsi CorBindToRuntimeByCfg untuk menentukan file konfigurasi, Anda harus menggunakan <requiredRuntime> elemen untuk semua versi runtime. Elemen <supportedRuntime> diabaikan saat Anda menggunakan CorBindToRuntimeByCfg.

Untuk aplikasi yang mendukung versi runtime dari .NET Framework 1.1 hingga 3.5, ketika beberapa versi runtime didukung, elemen pertama harus menentukan versi runtime yang paling disukai, dan elemen terakhir harus menentukan versi yang paling tidak disukai. Untuk aplikasi yang mendukung .NET Framework 4.0 atau versi yang lebih baru, version atribut menunjukkan versi CLR, yang umum untuk .NET Framework 4 dan versi yang lebih baru, dan sku atribut menunjukkan versi .NET Framework tunggal yang ditargetkan aplikasi.

<supportedRuntime> Jika elemen dengan sku atribut ada dalam file konfigurasi dan versi .NET Framework yang diinstal lebih rendah dari versi yang didukung yang ditentukan, aplikasi gagal dijalankan dan sebaliknya menampilkan pesan yang meminta untuk menginstal versi yang didukung. Jika tidak, aplikasi mencoba berjalan pada versi apa pun yang diinstal, tetapi mungkin berperilaku tidak terduga jika tidak sepenuhnya kompatibel dengan versi tersebut. (Untuk perbedaan kompatibilitas antara versi .NET Framework, lihat Kompatibilitas aplikasi di .NET Framework.) Oleh karena itu, kami sarankan Anda menyertakan elemen ini dalam file konfigurasi aplikasi untuk diagnostik kesalahan yang lebih mudah. (File konfigurasi yang dibuat secara otomatis oleh Visual Studio saat membuat proyek baru sudah berisinya.)

Nota

Jika aplikasi Anda menggunakan jalur aktivasi lama, seperti fungsi CorBindToRuntimeEx, dan Anda ingin jalur tersebut mengaktifkan versi 4 CLR alih-alih versi sebelumnya, atau jika aplikasi Anda dibangun dengan .NET Framework 4 tetapi memiliki dependensi pada rakitan mode campuran yang dibangun dengan versi .NET Framework yang lebih lama, tidak cukup untuk menentukan .NET Framework 4 dalam daftar runtime yang didukung. Selain itu, dalam <startup> elemen dalam file konfigurasi Anda, Anda harus mengatur atribut ke useLegacyV2RuntimeActivationPolicytrue. Namun, mengatur atribut ini untuk true berarti bahwa semua komponen yang dibangun dengan versi .NET Framework yang lebih lama dijalankan menggunakan .NET Framework 4 alih-alih runtime yang dibangun dengannya.

Kami menyarankan agar Anda menguji aplikasi dengan semua versi .NET Framework yang dapat mereka jalankan.

Nilai "versi runtime"

Atribut runtime menentukan versi Common Language Runtime (CLR) yang diperlukan untuk aplikasi tertentu. Semua versi .NET Framework v4.x menentukan v4.0 CLR. Tabel berikut mencantumkan nilai yang valid untuk nilai version atribut.

Versi .NET Framework atribut version
1.0 "v1.0.3705"
1.1 "v1.1.4322"
2.0 "v2.0.50727"
3.0 "v2.0.50727"
3.5 "v2.0.50727"
4.0-4.8.1 "v4.0"

Nilai "ID SKU"

Atribut sku ini menggunakan moniker kerangka kerja target (TFM) untuk menunjukkan versi .NET Framework yang ditargetkan aplikasi dan perlu dijalankan. Tabel berikut mencantumkan nilai valid yang didukung oleh sku atribut , dimulai dengan .NET Framework 4.

Versi .NET Framework atribut sku
4,0 ". NETFramework,Version=v4.0"
4.0, Profil Klien ". NETFramework,Version=v4.0,Profile=Client"
4.0, pembaruan platform 1 ". NETFramework,Version=v4.0.1"
4.0, Profil Klien, pembaruan 1 ". NETFramework,Version=v4.0.1,Profile=Client"
4.0, pembaruan platform 2 ". NETFramework,Version=v4.0.2"
4.0, Profil Klien, pembaruan 2 ". NETFramework,Version=v4.0.2,Profile=Client"
4.0, pembaruan platform 3 ". NETFramework,Version=v4.0.3"
4.0, Profil Klien, pembaruan 3 ". NETFramework,Version=v4.0.3,Profile=Client"
4.5 ". NETFramework,Version=v4.5"
4.5.1 ". NETFramework,Version=v4.5.1"
4.5.2 ". NETFramework,Version=v4.5.2"
4.6 ". NETFramework,Version=v4.6"
4.6.1 ". NETFramework,Version=v4.6.1"
4.6.2 ". NETFramework,Version=v4.6.2"
4.7 ". NETFramework,Version=v4.7"
4.7.1 ". NETFramework,Version=v4.7.1"
4.7.2 ". NETFramework,Version=v4.7.2"
4.8 ". NETFramework,Version=v4.8"
4.8.1 ". NETFramework,Version=v4.8.1"

Example

Contoh berikut menunjukkan cara menentukan versi runtime yang didukung dalam file konfigurasi. File konfigurasi menunjukkan bahwa aplikasi menargetkan .NET Framework 4.7.

<configuration>
   <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
   </startup>
</configuration>

File konfigurasi

Elemen ini dapat digunakan dalam file konfigurasi aplikasi.

Lihat juga

  • Last updated on