<supportedRuntime –> element
Určuje verzi modulu CLR (Common Language Runtime) a volitelně i verzi rozhraní .NET Framework, kterou aplikace podporuje.
<Konfigurace>
<Spuštění>
<supportedRuntime>
Syntax
<supportedRuntime version="runtime version" sku="SKU ID"/>
Atributy
| Atribut | Popis |
|---|---|
| Verze | Nepovinný atribut. Hodnota řetězce, která určuje verzi modulu Common Language Runtime (CLR), který 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á "verze modulu runtime" hodnotu hlavní. nezletilá.build. Počínaje rozhraním .NET Framework 4 se vyžadují pouze čísla hlavní verze a podverze (tj. "v4.0" místo "v4.0.30319"). Je doporučen kratší řetězec. |
| Sku | Nepovinný atribut. Řetězcová hodnota, která určuje skladovou jednotku (SKU), která zase určuje, kterou verzi rozhraní .NET Framework tato aplikace podporuje. Počínaje rozhraním .NET Framework 4.0 se doporučuje použít sku atribut . Pokud je k dispozici, označuje verzi rozhraní .NET Framework, na kterou aplikace cílí.Platné hodnoty atributu sku najdete v části "ID skladové položky" . |
Poznámky
<Pokud podporovaný elementRuntime> není přítomen v konfiguračním souboru aplikace, použije se verze modulu runtime použitého k sestavení aplikace.
Podporovaný< elementRuntime> by měly používat všechny aplikace vytvořené pomocí modulu runtime verze 1.1 nebo novější. Aplikace vytvořené tak, aby podporovaly pouze verzi 1.0 modulu runtime, musí používat <element requiredRuntime> .
Poznámka
Pokud použijete funkci CorBindToRuntimeByCfg k určení konfiguračního souboru, 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, první prvek by měl určovat upřednostňovanou verzi modulu runtime a poslední prvek by měl určovat nejméně upřednostňovanou verzi. U aplikací, které podporují .NET Framework 4.0 nebo novější verze, version atribut označuje verzi CLR, která je společná pro .NET Framework 4 a novější verze, a sku atribut označuje jednu verzi rozhraní .NET Framework, na kterou aplikace cílí.
Pokud je prvek supportedRuntime> s atributem přítomen v konfiguračním souboru a nainstalovaná verze rozhraní .NET Framework je nižší než zadaná podporovaná verze, aplikace se nespustí a místo toho zobrazí zprávu s žádostí o instalaci podporované verze.<sku V opačném případě se aplikace pokusí spustit v jakékoli 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 pro snadnější diagnostiku chyb. (Konfigurační soubor automaticky vygenerovaný sadou Visual Studio při vytváření nového projektu ho už 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 vytvořená pomocí rozhraní .NET Framework 4, ale je závislá na sestavení ve smíšeném režimu vytvořeném pomocí starší verze rozhraní .NET Framework, nestačí zadat rozhraní .NET Framework 4 v seznamu podporovaných modulů runtime. Kromě toho musíte v elementu< startup> v konfiguračním useLegacyV2RuntimeActivationPolicy souboru nastavit atribut na truehodnotu . Nastavení tohoto atributu na true však znamená, že všechny komponenty vytvořené pomocí předchozích verzí rozhraní .NET Framework jsou spuštěny pomocí rozhraní .NET Framework 4 místo modulů runtime, se kterými byly sestaveny.
Doporučujeme aplikaci otestovat se všemi verzemi .NET Framework, na kterých by měla být spuštěna.
Hodnoty verze 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 v4.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ého rozhraní (TFM) k označení verze rozhraní .NET Framework, na kterou aplikace cílí a vyžaduje spuštění. Následující tabulka obsahuje seznam platných hodnot podporovaných 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" |
Příklad
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 element lze použít v konfiguračním souboru aplikace.
