elemen <supportedRuntime>

Artikel
05/10/2023

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

<konfigurasi>
<startup>
<supportedRuntime>

Sintaks

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

Atribut

Atribut Deskripsi

versi Atribut opsional.

Nilai string yang menentukan versi runtime bahasa umum (CLR) yang didukung aplikasi ini. Untuk nilai atribut version yang valid, lihat bagian nilai "versi runtime bahasa umum". Catatan: Melalui .NET Framework 3.5, nilai "versi runtime" mengambil bentuk utama. anak di bawah umur. 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 stock-keeping (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" .

Atribut	Deskripsi
versi	Atribut opsional. Nilai string yang menentukan versi runtime bahasa umum (CLR) yang didukung aplikasi ini. Untuk nilai atribut `version` yang valid, lihat bagian nilai "versi runtime bahasa umum". Catatan: Melalui .NET Framework 3.5, nilai "versi runtime" mengambil bentuk utama. anak di bawah umur. 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 stock-keeping (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" .

Keterangan

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

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

Catatan

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

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

<Jika elemen supportedRuntime> dengan sku atribut ada dalam file konfigurasi dan versi .NET Framework yang diinstal lebih rendah dari versi yang didukung yang ditentukan, aplikasi gagal berjalan dan sebaliknya menampilkan pesan yang meminta untuk menginstal versi yang didukung. Jika tidak, aplikasi mencoba untuk berjalan pada versi yang dipasang, tetapi aplikasi mungkin berjalan 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 secara otomatis dihasilkan oleh Visual Studio saat membuat proyek baru sudah berisi file tersebut.)

Catatan

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

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

nilai "versi runtime bahasa umum”

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

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 dan diperlukan aplikasi untuk dijalankan. Tabel berikut mencantumkan nilai valid yang didukung oleh atribut sku, 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"

Contoh

Contoh berikut menunjukkan cara menentukan versi runtime bahasa umum 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.

Bagikan melalui