<supportedRuntime-element>

Artikel
05/10/2023

Hiermee geeft u op welke runtimeversie van de algemene taal en, optioneel, .NET Framework versie de toepassing ondersteunt.

<configuratie>
<Opstarten>
<supportedRuntime>

Syntax

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

Kenmerken

Kenmerk Beschrijving

version Optioneel kenmerk.

Een tekenreekswaarde die de versie van de Common Language Runtime (CLR) aangeeft die door deze toepassing wordt ondersteund. Zie de version sectie ' runtimeversie'-waarden voor geldige waarden van het kenmerk. Opmerking: Via .NET Framework 3.5 krijgt de waarde 'runtime version' de vorm major. minderjarig. bouwen. Vanaf de .NET Framework 4 zijn alleen de primaire en secundaire versienummers vereist (v4.0 in plaats van v4.0.30319). De kortere tekenreeks wordt aanbevolen.

sku Optioneel kenmerk.

Een tekenreekswaarde die de voorraadbewaareenheid (SKU) aangeeft, die op zijn beurt aangeeft welke .NET Framework release deze toepassing ondersteunt.

Vanaf .NET Framework 4.0 wordt het gebruik van het sku kenmerk aanbevolen. Indien aanwezig, wordt de versie van de .NET Framework aangegeven waarop de app is gericht.

Zie de sku sectie 'SKU ID'-waarden voor geldige waarden van het kenmerk.

Kenmerk	Beschrijving
version	Optioneel kenmerk. Een tekenreekswaarde die de versie van de Common Language Runtime (CLR) aangeeft die door deze toepassing wordt ondersteund. Zie de `version` sectie ' runtimeversie'-waarden voor geldige waarden van het kenmerk. Opmerking: Via .NET Framework 3.5 krijgt de waarde 'runtime version' de vorm major. minderjarig. bouwen. Vanaf de .NET Framework 4 zijn alleen de primaire en secundaire versienummers vereist (v4.0 in plaats van v4.0.30319). De kortere tekenreeks wordt aanbevolen.
sku	Optioneel kenmerk. Een tekenreekswaarde die de voorraadbewaareenheid (SKU) aangeeft, die op zijn beurt aangeeft welke .NET Framework release deze toepassing ondersteunt. Vanaf .NET Framework 4.0 wordt het gebruik van het `sku` kenmerk aanbevolen. Indien aanwezig, wordt de versie van de .NET Framework aangegeven waarop de app is gericht. Zie de `sku` sectie 'SKU ID'-waarden voor geldige waarden van het kenmerk.

Opmerkingen

Als het <element supportedRuntime> niet aanwezig is in het configuratiebestand van de toepassing, wordt de versie van de runtime gebruikt om de toepassing te bouwen.

Het <element supportedRuntime> moet worden gebruikt door alle toepassingen die zijn gebouwd met versie 1.1 of hoger van de runtime. Toepassingen die zijn gebouwd om alleen versie 1.0 van de runtime te ondersteunen, moeten het <element requiredRuntime> gebruiken.

Notitie

Als u de functie CorBindToRuntimeByCfg gebruikt om het configuratiebestand op te geven, moet u het <requiredRuntime> element voor alle versies van de runtime gebruiken. Het <supportedRuntime> element wordt genegeerd wanneer u CorBindToRuntimeByCfg gebruikt.

Voor apps die ondersteuning bieden voor versies van de runtime van de .NET Framework 1.1 tot en met 3.5, moet het eerste element, wanneer meerdere versies van de runtime worden ondersteund, de meest voorkeursversie van de runtime opgeven en het laatste element de versie met de minste voorkeur. Voor apps die ondersteuning bieden voor de .NET Framework 4.0 of latere versies, geeft het version kenmerk de CLR-versie aan, die gebruikelijk is voor de .NET Framework 4 en latere versies, en geeft het sku kenmerk de versie met één .NET Framework aan waarop de app is gericht.

Als het <element supportedRuntime> met het sku kenmerk aanwezig is in het configuratiebestand en de geïnstalleerde .NET Framework versie lager is dan de opgegeven ondersteunde versie, kan de toepassing niet worden uitgevoerd en wordt in plaats daarvan een bericht weergegeven waarin wordt gevraagd om de ondersteunde versie te installeren. Anders probeert de toepassing uit te voeren op een geïnstalleerde versie, maar kan deze zich onverwacht gedragen als deze niet volledig compatibel is met die versie. (Zie Toepassingscompatibiliteit in de .NET Framework voor compatibiliteitsverschillen tussen versies van .NET Framework.) Daarom raden we u aan dit element op te nemen in het configuratiebestand van de toepassing voor eenvoudigere foutdiagnose. (Het configuratiebestand dat automatisch door Visual Studio wordt gegenereerd bij het maken van een nieuw project, bevat dit bestand al.)

Notitie

Als uw toepassing verouderde activeringspaden gebruikt, zoals de functie CorBindToRuntimeEx, en u wilt dat deze paden versie 4 van de CLR activeren in plaats van een eerdere versie, of als uw toepassing is gebouwd met de .NET Framework 4, maar afhankelijk is van een assembly met gemengde modus die is gebouwd met een eerdere versie van de .NET Framework, is het niet voldoende om de .NET Framework 4 in de lijst met ondersteunde runtimes. Bovendien moet u in het <opstartelement> in het configuratiebestand het useLegacyV2RuntimeActivationPolicy kenmerk instellen op true. Als u dit kenmerk instelt optrue, betekent dit echter dat alle onderdelen die zijn gebouwd met eerdere versies van de .NET Framework worden uitgevoerd met behulp van de .NET Framework 4 in plaats van de runtimes waarmee ze zijn gebouwd.

We raden u aan toepassingen te testen met alle .NET Framework versies waarop ze kunnen worden uitgevoerd.

Waarden voor 'runtimeversie'

Het runtime kenmerk geeft de CLR-versie (Common Language Runtime) op die is vereist voor een bepaalde toepassing. In alle .NET Framework v4.x-versies wordt de v4.0 CLR opgegeven. De volgende tabel bevat geldige waarden voor de runtimeversiewaarde van het version kenmerk.

Versie van .NET Framework	`version`-kenmerk
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"

Waarden voor 'SKU-id'

Het sku kenmerk gebruikt een doelframework moniker (TFM) om de versie van .NET Framework aan te geven waarop de app is gericht en moet worden uitgevoerd. De volgende tabel bevat geldige waarden die worden ondersteund door het sku kenmerk, te beginnen met .NET Framework 4.

Versie van .NET Framework	`sku`-kenmerk
4,0	". NETFramework,Version=v4.0"
4.0, Clientprofiel	". NETFramework,Version=v4.0,Profile=Client"
4.0, platformupdate 1	". NETFramework,Version=v4.0.1"
4.0, Clientprofiel, update 1	". NETFramework,Version=v4.0.1,Profile=Client"
4.0, platformupdate 2	". NETFramework,Version=v4.0.2"
4.0, Clientprofiel, update 2	". NETFramework,Version=v4.0.2,Profile=Client"
4.0, platformupdate 3	". NETFramework,Version=v4.0.3"
4.0, Clientprofiel, update 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"

Voorbeeld

In het volgende voorbeeld ziet u hoe u de ondersteunde runtimeversie in een configuratiebestand opgeeft. Het configuratiebestand geeft aan dat de app is gericht op .NET Framework 4.7.

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

Configuratiebestand

Dit element kan worden gebruikt in het configuratiebestand van de toepassing.

Delen via