<< SupportedRuntime >-Element<supportedRuntime> element

Gibt an, welche Version der common Language Runtime und, optional, .NET Framework-Version der Anwendung unterstützt.Specifies which common language runtime version and, optionally, .NET Framework version the application supports.

<configuration><configuration>
  <startup>  <startup>
     <supportedRuntime>    <supportedRuntime>

SyntaxSyntax

<supportedRuntime version="runtime version" sku="sku id"/>

AttributeAttributes

AttributAttribute BeschreibungDescription
versionversion Optionales Attribut.Optional attribute.

Ein Zeichenfolgenwert, der die Version der Common Language Runtime (CLR) angibt, die diese Anwendung unterstützt.A string value that specifies the version of the common language runtime (CLR) that this application supports. Für gültige Werte für die version Attribut, finden Sie unter den "RuntimeVersion"-Werte Abschnitt.For valid values of the version attribute, see the "runtime version" values section. Hinweis: Über die .NET Framework 3.5 die "Laufzeitversion" Wert hat das Format wichtigen. kleinere. Erstellen Sie.Note: Through the .NET Framework 3.5, the "runtime version" value takes the form major.minor.build. Ab .NET Framework 4, nur die Nummern für Haupt-und Nebenversionsnummern erforderlich (d. h. "v4. 0" anstatt "v4.0.30319").Beginning with the .NET Framework 4, only the major and minor version numbers are required (that is, "v4.0" instead of "v4.0.30319"). Die kürzere Zeichenfolge wird empfohlen.The shorter string is recommended.
skusku Optionales Attribut.Optional attribute.

Ein Zeichenfolgenwert, der die SKU (Stock Keeping Unit) angibt, die wiederum angibt, welches .NET Framework-Release von dieser Anwendung unterstützt wird.A string value that specifies the stock-keeping unit (SKU), which in turn specifies which .NET Framework release this application supports.

Beginnend mit .NET Framework 4.0 wird die Verwendung des sku-Attributs empfohlen.Starting with the .NET Framework 4.0, the use of the sku attribute is recommended. Wenn vorhanden, gibt es die Version des .NET Frameworks an, auf die die App aufgerichtet ist.When present, it indicates the version of the .NET Framework that the app targets.

Gültige Werte des Sku-Attributs finden Sie in der "Sku Id"-Werte Abschnitt.For valid values of the sku attribute, see the "sku id" values section.

HinweiseRemarks

Wenn die <SupportedRuntime > Element ist nicht vorhanden ist, in der Konfigurationsdatei der Anwendung, die Version der Laufzeit verwendet, die zum Erstellen der Anwendung verwendet wird.If the <supportedRuntime> element is not present in the application configuration file, the version of the runtime used to build the application is used.

Die <SupportedRuntime > Element sollte verwendet werden, von allen Anwendungen, die mit Version 1.1 oder höher der Runtime erstellt.The <supportedRuntime> element should be used by all applications built using version 1.1 or later of the runtime. Anwendungen, die nur in Version 1.0 von der Laufzeit nicht verwenden, müssen die <RequiredRuntime > Element.Applications built to support only version 1.0 of the runtime must use the <requiredRuntime> element.

Hinweis

Bei Verwendung der CorBindToRuntimeByCfg Funktion, um die Konfigurationsdatei angeben, müssen Sie die <requiredRuntime> -Element für alle Versionen der Laufzeit.If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. Die <supportedRuntime> Element wird ignoriert, wenn Sie CorBindToRuntimeByCfg.The <supportedRuntime> element is ignored when you use CorBindToRuntimeByCfg.

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.For apps that support versions of the runtime from the .NET Framework 1.1 through 3.5, when multiple versions of the runtime are supported, the first element should specify the most preferred version of the runtime, and the last element should specify the least preferred version. Für apps, die .NET Framework 4.0 oder höhere Versionen unterstützen, die version -Attribut gibt an, die CLR-Version, die für die .NET Framework 4 und höher ist, und die sku -Attribut gibt an, die einzelnen .NET Framework-Version, die die App ausgerichtet ist.For apps that support the .NET Framework 4.0 or later versions, the version attribute indicates the CLR version, which is common to the .NET Framework 4 and later versions, and the sku attribute indicates the single .NET Framework version that the app targets.

Wenn die <SupportedRuntime > -Element mit dem sku Attribut in der Konfigurationsdatei vorhanden ist und die installierte .NET Framework-Version wird unten und klicken Sie dann die angegebenen unterstützte Version der Anwendung nicht ausgeführt werden, sondern zeigt stattdessen eine Meldung gefragt werden, um die unterstützte Version zu installieren.If the <supportedRuntime> element with the sku attribute is present in the configuration file and the installed .NET Framework version is lower then the specified supported version, the application fails to run and instead displays a message asking to install the supported version. Andernfalls wird die Anwendung versucht, die auf alle installierten Version ausgeführt werden, aber es kann unerwartet Verhalten, wenn er nicht vollständig kompatibel mit dieser Version ist.Otherwise, the application attempts to run on any installed version, but it may behave unexpectedly if it is not fully compatible with that version. (Kompatibilitätsunterschiede zwischen Versionen von .NET Framework, finden Sie unter der Anwendungskompatibilität in .NET Framework.) Aus diesem Grund empfehlen wir, dass Sie dieses Element in der Konfigurationsdatei der Anwendung für die Fehlerdiagnose von einfacher enthalten.(For compatibility differences between versions of .NET Framework, see Application compatibility in the .NET Framework.) Therefore, we recommend that you include this element in the application configuration file for easier error diagnostics. (Die Konfigurationsdatei von Visual Studio automatisch generiert, wenn es bereits ein neues Projekt erstellen enthält.)(The configuration file automatically generated by Visual Studio when creating a new project already contains it.)

Hinweis

Wenn Ihre Anwendung legacy-Aktivierungspfade, z. B. verwendet die CorBindToRuntimeEx-Funktion, und Sie möchten diese Pfade Version 4 der CLR anstelle von einer früheren Version aktivieren, oder wenn Ihre Anwendung mit .NET Framework erstellt wurde 4 verfügt jedoch über eine Abhängigkeit auf eine Assembly im gemischten Modus mit einer früheren Version von .NET Framework erstellt ist es nicht ausreichend, um .NET Framework 4 in der Liste der unterstützten Laufzeiten angeben.If your application uses legacy activation paths, such as the CorBindToRuntimeEx function, and you want those paths to activate version 4 of the CLR instead of an earlier version, or if your application is built with the .NET Framework 4 but has a dependency on a mixed-mode assembly built with an earlier version of the .NET Framework, it is not sufficient to specify the .NET Framework 4 in the list of supported runtimes. Darüber hinaus werden in der <Startup > Element in der Konfigurationsdatei müssen Sie festlegen der useLegacyV2RuntimeActivationPolicy Attribut true.In addition, in the <startup> element in your configuration file, you must set the useLegacyV2RuntimeActivationPolicy attribute to true. Wenn Sie dieses Attribut jedoch auf true bedeutet, die alle Komponenten, die mit früheren Versionen von .NET Framework ausgeführt werden, mithilfe von .NET Framework 4 statt den Laufzeiten, mit denen sie erstellt wurden.However, setting this attribute to true means that all components built with earlier versions of the .NET Framework are run using the .NET Framework 4 instead of the runtimes they were built with.

Es wird empfohlen, dass Sie die Anwendungen mit allen .NET Framework-Versionen testen, in denen sie ausgeführt werden können.We recommend that you test applications with all the .NET Framework versions that they can run on.

„runtime version“-Werte"runtime version" values

Die runtime Attribut gibt an, die Common Language Runtime (CLR)-Version, die für eine bestimmte Anwendung erforderlich ist.The runtime attribute specifies the Common Language Runtime (CLR) version that is required for a given application. Beachten Sie, die alle .NET Framework 4.x-Versionen angeben der v4.0 CLR.Note that all .NET Framework v4.x versions specify the v4.0 CLR. Die folgende Tabelle enthält die gültigen Werte für die Laufzeitversion Wert, der die version Attribut.The following table lists valid values for the runtime version value of the version attribute.

.NET Framework-Version.NET Framework version version Attributversion attribute
1.01.0 "v1.0.3705""v1.0.3705"
1.11.1 "v1.1.4322""v1.1.4322"
2.02.0 "v2.0.50727""v2.0.50727"
3.03.0 "v2.0.50727""v2.0.50727"
3.53.5 "v2.0.50727""v2.0.50727"
4.0-4.84.0-4.8 "v4.0""v4.0"

"Sku Id"-Werte"sku id" values

Die sku Attribut einen Zielframework-Moniker (TFM) verwendet, um die Version von .NET Framework anzugeben, die die app ausgerichtet ist und zum Ausführen benötigt.The sku attribute uses a target framework moniker (TFM) to indicate the version of the .NET Framework that the app targets and requires to run. Die folgende Tabelle enthält die gültigen Werte, die von Microsoft Intune die sku -Attribut, beginnend mit .NET Framework 4.The following table lists valid values that are supported by the sku attribute, starting with the .NET Framework 4.

.NET Framework-Version.NET Framework version sku Attributsku attribute
4.04.0 ".NETFramework,Version=v4.0"".NETFramework,Version=v4.0"
4.0, Clientprofil4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"".NETFramework,Version=v4.0,Profile=Client"
4.0, Plattformupdate 14.0, platform update 1 ".NETFramework,Version=v4.0.1"".NETFramework,Version=v4.0.1"
4.0, Clientprofil, Update 14.0, Client Profile, update 1 ". NETFramework, Version 4.0.1, Profil = = Client "".NETFramework,Version=v4.0.1,Profile=Client"
4.0, Plattformupdate 24.0, platform update 2 ".NETFramework,Version=v4.0.2"".NETFramework,Version=v4.0.2"
4.0, Clientprofil, Update 24.0, Client Profile, update 2 ". NETFramework, Version = V4.0.2, Profil = Client "".NETFramework,Version=v4.0.2,Profile=Client"
4.0, Plattformupdate 34.0, platform update 3 ".NETFramework,Version=v4.0.3"".NETFramework,Version=v4.0.3"
4.0, Clientprofil, Update 34.0, Client Profile, update 3 ". NETFramework, Version = Verze 4.0.3, Profil = Client "".NETFramework,Version=v4.0.3,Profile=Client"
4.54.5 ".NETFramework,Version=v4.5"".NETFramework,Version=v4.5"
4.5.14.5.1 ".NETFramework,Version=v4.5.1"".NETFramework,Version=v4.5.1"
4.5.24.5.2 ".NETFramework,Version=v4.5.2"".NETFramework,Version=v4.5.2"
4.64.6 ".NETFramework,Version=v4.6"".NETFramework,Version=v4.6"
4.6.14.6.1 ".NETFramework,Version=v4.6.1"".NETFramework,Version=v4.6.1"
4.6.24.6.2 ".NETFramework,Version=v4.6.2"".NETFramework,Version=v4.6.2"
4.74.7 ".NETFramework,Version=v4.7"".NETFramework,Version=v4.7"
4.7.14.7.1 ".NETFramework,Version=v4.7.1"".NETFramework,Version=v4.7.1"
4.7.24.7.2 ".NETFramework,Version=v4.7.2"".NETFramework,Version=v4.7.2"
4.84.8 ".NETFramework,Version=v4.8"".NETFramework,Version=v4.8"

BeispielExample

Das folgende Beispiel veranschaulicht, wie Sie die unterstützte Laufzeitversion in einer Konfigurationsdatei angeben.The following example shows how to specify the supported runtime version in a configuration file. Die Konfigurationsdatei gibt an, dass die app auf .NET Framework 4.7 ausgerichtet ist.The configuration file indicates that the app targets the .NET Framework 4.7.

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

KonfigurationsdateiConfiguration file

Dieses Element kann in der Anwendungskonfigurationsdatei verwendet werden.This element can be used in the application configuration file.

Siehe auchSee also