Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Meghatározza, hogy melyik közös nyelvi futtatókörnyezeti verziót, és opcionálisan az alkalmazás által támogatott .NET-keretrendszer-verziót.
<configuration>
<startup>
<supportedRuntime>
Szemantika
<supportedRuntime version="runtime version" sku="SKU ID"/>
Attributes
| Attribute | Description |
|---|---|
| version | Nem kötelező attribútum. Sztringérték, amely meghatározza az alkalmazás által támogatott közös nyelvi futtatókörnyezet (CLR) verzióját. Az attribútum érvényes értékeit version a "futtatókörnyezeti verzió" értékek szakaszában találja.
Jegyzet: A .NET-keretrendszer 3.5-ös verziójában a "futtatókörnyezet verziója" érték az űrlap főverziója. alverzió. buildeléshez. A .NET-keretrendszer 4-es verziójától kezdve csak a fő- és alverziószámok szükségesek (azaz a "v4.0.30319" helyett a "v4.0.30319" helyett). A rövidebb sztring használata ajánlott. |
| Sku | Nem kötelező attribútum. Egy sztringérték, amely megadja a készletmegőrzési egységet (SKU), amely viszont meghatározza, hogy az alkalmazás mely .NET-keretrendszer-kiadásokat támogatja. A .NET-keretrendszer 4.0-s verziójától kezdve az attribútum használata sku ajánlott. Jelen esetben az alkalmazás által megcélzott .NET-keretrendszer verzióját jelzi.Az attribútum érvényes értékeit az sku"SKU-azonosító" értékek szakaszában találja. |
Megjegyzések
Ha az <supportedRuntime> elem nincs jelen az alkalmazáskonfigurációs fájlban, a rendszer az alkalmazás létrehozásához használt futtatókörnyezet verzióját használja.
Az <supportedRuntime> elemet minden olyan alkalmazásnak használnia kell, amely a futtatókörnyezet 1.1-es vagy újabb verziójával készült. A futtatókörnyezet csak 1.0-s verziójának támogatásához készült alkalmazásoknak a <szükségesRuntime> elemet kell használniuk.
Megjegyzés:
Ha a CorBindToRuntimeByCfg függvénnyel adja meg a konfigurációs fájlt, az elemet a <requiredRuntime> futtatókörnyezet összes verziójához használnia kell. A <supportedRuntime>CorBindToRuntimeByCfg használatakor a rendszer figyelmen kívül hagyja az elemet.
A .NET-keretrendszer 1.1-től 3.5-ös verziójáig futó futtatókörnyezet verzióit támogató alkalmazások esetében, ha a futtatókörnyezet több verziója is támogatott, az első elemnek a futtatókörnyezet legkedveltebb verzióját kell megadnia, az utolsó elemnek pedig a legkevésbé előnyben részesített verziót kell megadnia. A .NET-keretrendszer 4.0-s vagy újabb verzióit támogató alkalmazások esetében az version attribútum a .NET-keretrendszer 4-es és újabb verzióiban gyakran használt CLR-verziót jelöli, az attribútum pedig sku az alkalmazás által megcélzott egyetlen .NET-keretrendszer-verziót jelöli.
Ha az <supportedRuntime>sku attribútummal rendelkező elem megtalálható a konfigurációs fájlban, és a telepített .NET-keretrendszer verziója alacsonyabb a megadott támogatott verziónál, az alkalmazás nem fut, és ehelyett egy üzenetet jelenít meg, amely a támogatott verzió telepítését kéri. Ellenkező esetben az alkalmazás bármilyen telepített verzión megpróbál futni, de váratlanul viselkedhet, ha nem teljes mértékben kompatibilis az adott verzióval. (A .NET-keretrendszer verziói közötti kompatibilitási különbségekért lásd : Alkalmazáskompatibilitás a .NET-keretrendszerben.) Ezért javasoljuk, hogy a könnyebb hibadiagnosztika érdekében vegye fel ezt az elemet az alkalmazáskonfigurációs fájlba. (A Visual Studio által automatikusan létrehozott konfigurációs fájl egy új projekt létrehozásakor már tartalmazza.)
Megjegyzés:
Ha az alkalmazás örökölt aktiválási útvonalakat használ, például a CorBindToRuntimeEx függvényt, és azt szeretné, hogy ezek az útvonalak a CLR 4-es verzióját aktiválják egy korábbi verzió helyett, vagy ha az alkalmazás a .NET-keretrendszer 4-es verziójával készült, de függőségben van a .NET-keretrendszer egy korábbi verziójával készült vegyes módú szerelvényen, nem elegendő megadni a .NET-keretrendszer 4-et a támogatott futtatókörnyezetek listájában. Emellett a <startup> konfigurációs fájl elemében az attribútumot a következőre kell beállítania useLegacyV2RuntimeActivationPolicytrue: . Az attribútum true beállítása azonban azt jelenti, hogy a .NET-keretrendszer korábbi verzióival készült összes összetevő a .NET-keretrendszer 4 használatával fut, nem pedig azokkal a futtatókörnyezetekkel, amelyekkel készültek.
Javasoljuk, hogy tesztelje az alkalmazásokat az összes .NET-keretrendszer-verzióval, amelyen futtathatók.
"futtatókörnyezeti verzió" értékek
Az runtime attribútum az adott alkalmazáshoz szükséges Common Language Runtime (CLR) verziót adja meg. Az összes .NET-keretrendszer v4.x verziója megadja a CLR-t v4.0 . Az alábbi táblázat az attribútum futtatókörnyezeti verzióértékének érvényes értékeit sorolja fel version .
| .NET-keretrendszer verziója |
version attribútum |
|---|---|
| 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" |
"Termékváltozat azonosítója" értékek
Az sku attribútum egy cél-keretrendszer-moniker (TFM) használatával jelzi a .NET-keretrendszer azon verzióját, amelyet az alkalmazás megcéloz, és futtatnia kell. Az alábbi táblázat az attribútum által sku támogatott érvényes értékeket sorolja fel a .NET-keretrendszer 4-től kezdve.
| .NET-keretrendszer verziója |
sku attribútum |
|---|---|
| 4,0 | ". NETFramework,Version=v4.0" |
| 4.0, ügyfélprofil | ". NETFramework,Version=v4.0,Profile=Client" |
| 4.0, 1. platformfrissítés | ". NETFramework,Version=v4.0.1" |
| 4.0, Ügyfélprofil, 1. frissítés | ". NETFramework,Version=v4.0.1,Profile=Client" |
| 4.0, 2. platformfrissítés | ". NETFramework,Version=v4.0.2" |
| 4.0, Ügyfélprofil, 2. frissítés | ". NETFramework,Version=v4.0.2,Profile=Client" |
| 4.0, 3. platformfrissítés | ". NETFramework,Version=v4.0.3" |
| 4.0, Ügyfélprofil, 3. frissítés | ". 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
Az alábbi példa bemutatja, hogyan adhatja meg a támogatott futtatókörnyezeti verziót egy konfigurációs fájlban. A konfigurációs fájl azt jelzi, hogy az alkalmazás a .NET-keretrendszer 4.7-et célozza.
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
</startup>
</configuration>
Konfigurációs fájl
Ez az elem használható az alkalmazáskonfigurációs fájlban.
Lásd még
Dolgozzon együtt velünk a GitHubon
A tartalom forrása a GitHubon található, ahol létrehozhat és áttekinthet problémákat és lekéréses kérelmeket is. További információért tekintse meg a közreműködői útmutatónkat.
