Dela via

<supportedRuntime-element>

  • Artikel

Anger vilken vanlig språkkörningsversion och, om du vill, .NET Framework version som programmet stöder.

<Konfiguration>
  <Start>
    <supportedRuntime>

Syntax

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

Attribut

Attribut Beskrivning
Version Valfritt attribut.

Ett strängvärde som anger vilken version av CLR (Common Language Runtime) som det här programmet stöder. Giltiga värden för version attributet finns i avsnittet "körningsversion"-värden . Observera: Till och med .NET Framework 3.5 har värdet "runtime version" formatet huvudversion. mindre. bygga. Från och med .NET Framework 4 krävs endast huvud- och delversionsnummer (dvs. "v4.0" i stället för "v4.0.30319"). Den kortare strängen rekommenderas.
Sku Valfritt attribut.

Ett strängvärde som anger lagerhållningsenheten (SKU), som i sin tur anger vilken .NET Framework version som programmet stöder.

Från och med .NET Framework 4.0 rekommenderas användning av sku attributet. När den finns anger den version av .NET Framework som appen har som mål.

Giltiga värden för sku attributet finns i avsnittet "SKU ID"-värden .

Kommentarer

Om elementet <supportedRuntime> inte finns i programkonfigurationsfilen används versionen av den körning som används för att skapa programmet.

Elementet <supportedRuntime> ska användas av alla program som skapats med version 1.1 eller senare av körningen. Program som endast har stöd för version 1.0 av körningen måste använda elementet <requiredRuntime> .

Anteckning

Om du använder funktionen CorBindToRuntimeByCfg för att ange konfigurationsfilen måste du använda -elementet <requiredRuntime> för alla versioner av körningen. Elementet <supportedRuntime> ignoreras när du använder CorBindToRuntimeByCfg.

För appar som stöder versioner av körningen från .NET Framework 1.1 till 3.5, när flera versioner av körningen stöds, bör det första elementet ange den mest föredragna versionen av körningen och det sista elementet ska ange den minst föredragna versionen. För appar som stöder .NET Framework 4.0 eller senare versioner version anger attributet CLR-versionen, som är gemensam för .NET Framework 4 och senare versioner, och sku attributet anger den enda .NET Framework version som appen riktar sig mot.

Om elementet <supportedRuntime> med sku attributet finns i konfigurationsfilen och den installerade .NET Framework versionen är lägre än den angivna versionen som stöds, kan programmet inte köras och i stället visas ett meddelande om att installera den version som stöds. Annars försöker programmet köras på valfri installerad version, men det kan bete sig oväntat om det inte är helt kompatibelt med den versionen. (Information om kompatibilitetsskillnader mellan versioner av .NET Framework finns i Programkompatibilitet i .NET Framework.) Därför rekommenderar vi att du inkluderar det här elementet i programkonfigurationsfilen för enklare feldiagnostik. (Konfigurationsfilen som genereras automatiskt av Visual Studio när du skapar ett nytt projekt innehåller den redan.)

Anteckning

Om programmet använder äldre aktiveringssökvägar, till exempel funktionen CorBindToRuntimeEx, och du vill att dessa sökvägar ska aktivera version 4 av CLR i stället för en tidigare version, eller om ditt program har skapats med .NET Framework 4 men har ett beroende av en sammansättning i blandat läge som skapats med en tidigare version av .NET Framework, räcker det inte att ange sammansättningen i blandat läge som skapats med en tidigare version av .NET Framework. .NET Framework 4 i listan över körningar som stöds. I startelementet> i< konfigurationsfilen måste du dessutom ange useLegacyV2RuntimeActivationPolicy attributet till true. Om det här attributet anges till true innebär det dock att alla komponenter som skapats med tidigare versioner av .NET Framework körs med hjälp av .NET Framework 4 i stället för de körningsmiljöer som de har skapats med.

Vi rekommenderar att du testar program med alla .NET Framework versioner som de kan köras på.

Värden för "körningsversion"

Attributet runtime anger clr-versionen (Common Language Runtime) som krävs för ett visst program. Alla .NET Framework v4.x-versioner anger v4.0 CLR. I följande tabell visas giltiga värden för körningsversionsvärdet för attributet version .

.NET Framework-version version-attribut
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"

SKU-ID-värden

Attributet sku använder en målramverksmoniker (TFM) för att ange vilken version av .NET Framework som appen riktar sig mot och behöver köra. I följande tabell visas giltiga värden som stöds av sku attributet, från och med .NET Framework 4.

.NET Framework-version sku-attribut
4,0 ". NETFramework,Version=v4.0"
4.0, Klientprofil ". NETFramework,Version=v4.0,Profile=Client"
4.0, plattformsuppdatering 1 ". NETFramework,Version=v4.0.1"
4.0, Klientprofil, uppdatering 1 ". NETFramework,Version=v4.0.1,Profile=Client"
4.0, plattformsuppdatering 2 ". NETFramework,Version=v4.0.2"
4.0, Klientprofil, uppdatering 2 ". NETFramework,Version=v4.0.2,Profile=Client"
4.0, plattformsuppdatering 3 ". NETFramework,Version=v4.0.3"
4.0, Klientprofil, uppdatering 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"

Exempel

I följande exempel visas hur du anger vilken körningsversion som stöds i en konfigurationsfil. Konfigurationsfilen anger att appen har som mål .NET Framework 4.7.

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

Konfigurationsfil

Det här elementet kan användas i programkonfigurationsfilen.

Se även