<supportedRuntime> prvek

Určuje, která verze modulu CLR (Common Language Runtime) a volitelně i verze rozhraní .NET Framework, kterou aplikace podporuje.

<configuration>   <startup>     <supportedRuntime>

Syntaxe

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

Attributes

Vlastnost Description
version Volitelný atribut.

Řetězcová hodnota, která určuje verzi modulu CLR (Common Language Runtime), kterou tato aplikace podporuje. Platné hodnoty atributu version najdete v části s hodnotami verze modulu runtime . Poznámka: Prostřednictvím rozhraní .NET Framework 3.5 má hodnota runtime verzihlavní podobu. menší.sestavení. Počínaje rozhraním .NET Framework 4 jsou vyžadována pouze čísla hlavních a podverze (tj. "v4.0" místo "v4.0.30319"). Doporučuje se kratší řetězec.
sku Volitelný atribut.

Řetězcová hodnota, která určuje skladovou jednotku (SKU), která zase určuje, která verze rozhraní .NET Framework tuto aplikaci podporuje.

Počínaje rozhraním .NET Framework 4.0 se doporučuje použití atributu sku . Pokud je k dispozici, označuje verzi rozhraní .NET Framework, kterou aplikace cílí.

Platné hodnoty atributu sku najdete v části SKU ID .

Poznámky

<supportedRuntime> Pokud prvek není součástí konfiguračního souboru aplikace, použije se verze modulu runtime použitého k sestavení aplikace.

Tento <supportedRuntime> prvek by měly používat všechny aplikace vytvořené pomocí verze 1.1 nebo novější modulu runtime. Aplikace vytvořené tak, aby podporovaly pouze verzi 1.0 modulu runtime, musí používat <element requiredRuntime> .

Poznámka:

Pokud k určení konfiguračního souboru použijete funkci CorBindToRuntimeByCfg , musíte použít <requiredRuntime> element pro všechny verze modulu runtime. Element <supportedRuntime> je ignorován při použití CorBindToRuntimeByCfg.

Pro aplikace, které podporují verze modulu runtime z rozhraní .NET Framework 1.1 až 3.5, pokud je podporováno více verzí modulu runtime, by měl první prvek určit upřednostňovanou verzi modulu runtime a poslední prvek by měl určovat nejméně upřednostňovanou verzi. U aplikací, které podporují rozhraní .NET Framework 4.0 nebo novější verze, version označuje atribut verzi CLR, která je společná pro rozhraní .NET Framework 4 a novější verze, a sku atribut označuje jednu verzi rozhraní .NET Framework, kterou aplikace cílí.

<supportedRuntime> Pokud je prvek s atributem sku v konfiguračním souboru a nainstalovaná verze rozhraní .NET Framework je nižší než zadaná podporovaná verze, aplikace se nepovede spustit a místo toho zobrazí zprávu s žádostí o instalaci podporované verze. Jinak se aplikace pokusí spustit na libovolné nainstalované verzi, ale může se chovat neočekávaně, pokud není plně kompatibilní s danou verzí. (Rozdíly v kompatibilitě mezi verzemi rozhraní .NET Framework najdete v tématu Kompatibilita aplikací v rozhraní .NET Framework.) Proto doporučujeme, abyste tento prvek zahrnuli do konfiguračního souboru aplikace, abyste usnadnili diagnostiku chyb. (Konfigurační soubor automaticky vygenerovaný sadou Visual Studio při vytváření nového projektu již obsahuje.)

Poznámka:

Pokud vaše aplikace používá starší aktivační cesty, jako je například funkce CorBindToRuntimeEx, a chcete, aby tyto cesty aktivovaly verzi 4 modulu CLR místo starší verze, nebo pokud je vaše aplikace sestavená pomocí rozhraní .NET Framework 4, ale má závislost na sestavení smíšeného režimu vytvořeném se starší verzí rozhraní .NET Framework, V seznamu podporovaných modulů runtime nestačí zadat rozhraní .NET Framework 4. Kromě toho v elementu v konfiguračním <startup> souboru musíte nastavit useLegacyV2RuntimeActivationPolicy atribut na true. Nastavení tohoto atributu true však znamená, že všechny komponenty vytvořené se staršími verzemi rozhraní .NET Framework se spouští pomocí rozhraní .NET Framework 4 místo modulů runtime, se kterými byly sestaveny.

Doporučujeme testovat aplikace se všemi verzemi rozhraní .NET Framework, na kterých mohou běžet.

Hodnoty modulu runtime

Atribut runtime určuje verzi modulu CLR (Common Language Runtime), která se vyžaduje pro danou aplikaci. Všechny verze rozhraní .NET Framework verze 4.x určují v4.0 CLR. Následující tabulka uvádí platné hodnoty pro hodnotu verze modulu runtime atributu version .

Verze rozhraní .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"

Hodnoty "ID skladové položky"

Atribut sku používá moniker cílové architektury (TFM) k označení verze rozhraní .NET Framework, kterou aplikace cílí a vyžaduje ke spuštění. Následující tabulka uvádí platné hodnoty podporované atributem sku počínaje rozhraním .NET Framework 4.

Verze rozhraní .NET Framework atribut sku
4.0 ". NETFramework,Version=v4.0"
4.0, Profil klienta ". NETFramework,Version=v4.0,Profile=Client"
4.0, aktualizace platformy 1 ". NETFramework,Version=v4.0.1"
4.0, Profil klienta, aktualizace 1 ". NETFramework,Version=v4.0.1,Profile=Client"
4.0, aktualizace platformy 2 ". NETFramework,Version=v4.0.2"
4.0, Profil klienta, aktualizace 2 ". NETFramework,Version=v4.0.2,Profile=Client"
4.0, aktualizace platformy 3 ". NETFramework,Version=v4.0.3"
4.0, Profil klienta, aktualizace 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

Následující příklad ukazuje, jak zadat podporovanou verzi modulu runtime v konfiguračním souboru. Konfigurační soubor označuje, že aplikace cílí na rozhraní .NET Framework 4.7.

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

Konfigurační soubor

Tento prvek lze použít v konfiguračním souboru aplikace.

Viz také

  • Last updated on