Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt an, welche Common Language Runtime-Version und optional .NET Framework-Version die Anwendung unterstützt.
<Konfigurationsstart><><unterstütztRuntime>
Syntax
<supportedRuntime version="runtime version" sku="SKU ID"/>
Attribute
| Merkmal | Description |
|---|---|
| version | Optionales Attribut. Ein Zeichenfolgenwert, der die Version der Common Language Runtime (CLR) angibt, die von dieser Anwendung unterstützt wird. Gültige Werte des version Attributs finden Sie im Abschnitt "Laufzeitversion" .
Anmerkung: Über .NET Framework 3.5 übernimmt der Wert "Laufzeitversion" den Hauptwert. neben.build. Ab .NET Framework 4 sind nur die Haupt- und Nebenversionsnummern erforderlich (d. h. "v4.0" anstelle von "v4.0.30319"). Die kürzere Zeichenfolge wird empfohlen. |
| SKU | Optionales Attribut. Ein Zeichenfolgenwert, der die Aktienhaltungseinheit (Stock-Keeping Unit, SKU) angibt, die wiederum angibt, welche .NET Framework-Version diese Anwendung unterstützt. Ab .NET Framework 4.0 wird die Verwendung des sku Attributs empfohlen. Wenn vorhanden, gibt sie die Version von .NET Framework an, auf die die App ausgerichtet ist.Gültige Werte des sku Attributs finden Sie im Abschnitt "SKU-ID" . |
Bemerkungen
Wenn das <supportedRuntime> Element in der Anwendungskonfigurationsdatei nicht vorhanden ist, wird die Zum Erstellen der Anwendung verwendete Laufzeitversion verwendet.
Das <supportedRuntime> Element sollte von allen Anwendungen verwendet werden, die mit Version 1.1 oder höher der Laufzeit erstellt wurden. Anwendungen, die nur Version 1.0 der Laufzeit unterstützen, müssen das <erforderlicheRuntime-Element> verwenden.
Hinweis
Wenn Sie die CorBindToRuntimeByCfg-Funktion verwenden, um die Konfigurationsdatei anzugeben, müssen Sie das <requiredRuntime> Element für alle Versionen der Laufzeit verwenden. Das <supportedRuntime> Element wird ignoriert, wenn Sie CorBindToRuntimeByCfg verwenden.
Für Apps, die Versionen der Laufzeit von .NET Framework 1.1 bis 3.5 unterstützen, sollte das erste Element die am häufigsten bevorzugte Version der Laufzeit angeben, und das letzte Element sollte die am wenigsten bevorzugte Version angeben. Für Apps, die .NET Framework 4.0 oder höhere Versionen unterstützen, gibt das version Attribut die CLR-Version an, die für .NET Framework 4 und höher gilt, und das sku Attribut gibt die einzelne .NET Framework-Version an, auf die die App ausgerichtet ist.
Wenn das <supportedRuntime> Element mit dem sku Attribut in der Konfigurationsdatei vorhanden ist und die installierte .NET Framework-Version niedriger als die angegebene unterstützte Version ist, wird die Anwendung nicht ausgeführt und zeigt stattdessen eine Meldung an, in der Sie aufgefordert werden, die unterstützte Version zu installieren. Andernfalls versucht die Anwendung, auf einer installierten Version auszuführen, verhält sich jedoch möglicherweise unerwartet, wenn sie nicht vollständig mit dieser Version kompatibel ist. (Kompatibilitätsunterschiede zwischen .NET Framework-Versionen finden Sie unter Anwendungskompatibilität in .NET Framework.) Daher wird empfohlen, dieses Element in die Anwendungskonfigurationsdatei einzufügen, um die Fehlerdiagnose zu vereinfachen. (Die von Visual Studio beim Erstellen eines neuen Projekts generierte Konfigurationsdatei enthält sie bereits.)
Hinweis
Wenn Ihre Anwendung Legacyaktivierungspfade verwendet, z. B. die CorBindToRuntimeEx-Funktion, und sie möchten, dass diese Pfade Version 4 der CLR anstelle einer früheren Version aktivieren, oder wenn Ihre Anwendung mit .NET Framework 4 erstellt wird, aber von einer gemischten Assembly abhängig ist, die mit einer früheren Version von .NET Framework erstellt wurde, es reicht nicht aus, um .NET Framework 4 in der Liste der unterstützten Laufzeiten anzugeben. Darüber hinaus müssen Sie im <startup> Element in Der Konfigurationsdatei das useLegacyV2RuntimeActivationPolicy Attribut auf truefestlegen. Das Festlegen dieses Attributs true bedeutet jedoch, dass alle Komponenten, die mit früheren Versionen von .NET Framework erstellt wurden, mithilfe von .NET Framework 4 anstelle der Laufzeiten ausgeführt werden, mit denen sie erstellt wurden.
Es wird empfohlen, Anwendungen mit allen .NET Framework-Versionen zu testen, auf denen sie ausgeführt werden können.
Werte für "Laufzeitversion"
Das runtime Attribut gibt die ClR-Version (Common Language Runtime) an, die für eine bestimmte Anwendung erforderlich ist. Alle .NET Framework v4.x-Versionen geben die v4.0 CLR an. In der folgenden Tabelle sind gültige Werte für den Laufzeitversionswert des version Attributs aufgeführt.
| .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"-Werte
Das sku Attribut verwendet einen Zielframework-Moniker (TFM), um die Version von .NET Framework anzugeben, auf die die App ausgerichtet ist und ausgeführt werden muss. In der folgenden Tabelle sind gültige Werte aufgeführt, die sku vom Attribut unterstützt werden, beginnend mit .NET Framework 4.
| .NET Framework-Version |
sku-Attribut |
|---|---|
| 4,0 | ". NETFramework,Version=v4.0" |
| 4.0, Clientprofil | ". NETFramework,Version=v4.0,Profile=Client" |
| 4.0, Plattformupdate 1 | ". NETFramework,Version=v4.0.1" |
| 4.0, Clientprofil, Update 1 | ". NETFramework,Version=v4.0.1,Profile=Client" |
| 4.0, Plattformupdate 2 | ". NETFramework,Version=v4.0.2" |
| 4.0, Clientprofil, Update 2 | ". NETFramework,Version=v4.0.2,Profile=Client" |
| 4.0, Plattformupdate 3 | ". NETFramework,Version=v4.0.3" |
| 4.0, Clientprofil, 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" |
Example
Das folgende Beispiel zeigt, wie Die unterstützte Laufzeitversion in einer Konfigurationsdatei angegeben wird. Die Konfigurationsdatei gibt an, dass die App auf .NET Framework 4.7 ausgerichtet ist.
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
</startup>
</configuration>
Konfigurationsdatei
Dieses Element kann in der Anwendungskonfigurationsdatei verwendet werden.
Siehe auch
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
