<supportedRuntime>-Element

Artikel
06/05/2023

Gibt an, welche Versionen der Common Language Runtime (CLR) und optional von .NET Framework von der Anwendung unterstützt werden.

<configuration>
<startup>
<supportedRuntime>

Syntax

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

Attribute

attribute BESCHREIBUNG

version Optionales Attribut.

Ein Zeichenfolgenwert, der die Version der Common Language Runtime (CLR) angibt, die diese Anwendung unterstützt. Gültige Werte des version-Attributs finden Sie im Abschnitt Werte für „Laufzeitversion“. Hinweis: Bis .NET Framework 3.5 wird der Wert Laufzeitversion im Format Hauptversionsnummer.Nebenversionsnummer.Buildnummer angegeben. Ab .NET Framework 4 sind nur die Haupt- und die Nebenversionsnummer erforderlich (d. h. „v4.0“ anstelle von „v4.0.30319“). Die kürzere Zeichenfolge wird empfohlen.

sku Optionales Attribut.

Ein Zeichenfolgenwert, der die SKU (Stock Keeping Unit) angibt, die wiederum angibt, welches .NET Framework-Release von dieser Anwendung unterstützt wird.

Ab .NET Framework 4.0 wird die Verwendung des sku-Attributs empfohlen. Wenn vorhanden, gibt es die Version des .NET Frameworks an, auf die die App aufgerichtet ist.

Gültige Werte des sku-Attributs finden Sie im Abschnitt Werte für „SKU-ID“.

attribute	BESCHREIBUNG
version	Optionales Attribut. Ein Zeichenfolgenwert, der die Version der Common Language Runtime (CLR) angibt, die diese Anwendung unterstützt. Gültige Werte des `version`-Attributs finden Sie im Abschnitt Werte für „Laufzeitversion“. Hinweis: Bis .NET Framework 3.5 wird der Wert Laufzeitversion im Format Hauptversionsnummer.Nebenversionsnummer.Buildnummer angegeben. Ab .NET Framework 4 sind nur die Haupt- und die Nebenversionsnummer erforderlich (d. h. „v4.0“ anstelle von „v4.0.30319“). Die kürzere Zeichenfolge wird empfohlen.
sku	Optionales Attribut. Ein Zeichenfolgenwert, der die SKU (Stock Keeping Unit) angibt, die wiederum angibt, welches .NET Framework-Release von dieser Anwendung unterstützt wird. Ab .NET Framework 4.0 wird die Verwendung des `sku`-Attributs empfohlen. Wenn vorhanden, gibt es die Version des .NET Frameworks an, auf die die App aufgerichtet ist. Gültige Werte des `sku`-Attributs finden Sie im Abschnitt Werte für „SKU-ID“.

Bemerkungen

Ist das <supportedRuntime>-Element nicht in der Konfigurationsdatei der Anwendung vorhanden, wird die Version der Laufzeit verwendet, die zum Erstellen der Anwendung verwendet wurde.

Das <supportedRuntime>-Element sollte von allen Anwendungen verwendet werden, die mit Version 1.1 oder einer höheren Version der Runtime erstellt wurden. Anwendungen, die nur Version 1.0 der Runtime unterstützen, müssen das <requiredRuntime>-Element verwenden.

Hinweis

Wenn Sie die Konfigurationsdatei mithilfe der CorBindToRuntimeByCfg-Funktion angeben, müssen Sie das <requiredRuntime>-Element für alle Versionen der Runtime verwenden. Das <supportedRuntime>-Element wird ignoriert, wenn Sie CorBindToRuntimeByCfg verwenden.

Bei Apps, die Versionen der Laufzeit aus .NET Framework 1.1 bis 3.5 unterstützen, sollte, wenn mehrere Versionen der Laufzeit unterstützt werden, das erste Element die bevorzugte Version der Laufzeit angeben, und das letzte die am wenigsten bevorzugte Version. Bei 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öhere Versionen üblich ist, während das sku-Attribut die jeweilige .NET Framework-Version angibt, auf die die App ausgerichtet ist.

Ist das <supportedRuntime>-Element mit dem sku-Attribut in der Konfigurationsdatei vorhanden und stellt die installierte .NET Framework-Version eine frühere Version als die angegebene unterstützte Version dar, kann die Anwendung nicht ausgeführt werden. Stattdessen wird eine Meldung angezeigt, in der Sie zur Installation der unterstützten Version aufgefordert werden. Andernfalls wird die Anwendung auf jeder installierten Version ausgeführt, doch ihr Verhalten kann unerwartet sein, wenn sie mit dieser Version nicht vollständig kompatibel ist. (Informationen zu Kompatibilitätsunterschieden zwischen .NET Framework-Versionen finden Sie unter Anwendungskompatibilität in .NET Framework.) Daher wird empfohlen, dieses Element der Anwendungskonfigurationsdatei hinzuzufügen, um Fehler leichter diagnostizieren zu können. (In der Konfigurationsdatei, die von Visual Studio automatisch beim Erstellen eines neuen Projekts generiert wird, ist das Element bereits enthalten.)

Hinweis

Wenn Ihre Anwendung Legacy-Aktivierungspfade verwendet, z. B. die Funktion CorBindToRuntimeEx, 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 wurde, aber eine Abhängigkeit von einer gemischten Assembly aufweist, die mit einer früheren Version von .NET Framework erstellt wurde, reicht es nicht aus, .NET Framework 4 in der Liste der unterstützten Laufzeiten anzugeben. Zusätzlich müssen Sie im <startup>-Element Ihrer Konfigurationsdatei das Attribut useLegacyV2RuntimeActivationPolicy auf true festlegen. Wird jedoch dieses Attribut auf true festgelegt, werden alle Komponenten, die mit früheren Versionen von .NET Framework erstellt wurden, mit .NET Framework 4 ausgeführt und nicht mit den Laufzeiten, mit denen sie erstellt wurden.

Es wird empfohlen, dass Sie die Anwendungen mit allen .NET Framework-Versionen testen, in denen sie ausgeführt werden können.

„runtime version“-Werte

Das runtime-Attribut gibt die CLR-Version (Common Language Runtime) an, die für eine bestimmte Anwendung erforderlich ist. Alle v4.x-Versionen von .NET Framework geben die CLR v4.0 an. In der folgenden Tabelle sind gültige Werte für den Wert Laufzeitversion 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"

Werte für „SKU-ID“

Das sku-Attribut verwendet einen Zielframeworkmoniker (Target Framework Moniker, TFM), um die Version von .NET Framework anzugeben, auf die die App ausgerichtet ist und die für ihre Ausführung erforderlich ist. In der folgenden Tabelle sind gültige Werte aufgeführt, die ab .NET Framework 4 vom sku-Attribut unterstützt werden.

.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“

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie die unterstützte Laufzeitversion in einer Konfigurationsdatei angeben. 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.

Freigeben über