<requiredRuntime>-Element

Artikel
03/30/2023

Gibt an, dass die Anwendung nur Version 1.0 der Common Language Runtime unterstützt. Dieses Element ist veraltet und sollte nicht mehr verwendet werden. Stattdessen sollte das supportedRuntime-Element verwendet werden.

<configuration>
<startup>
<requiredRuntime>

Syntax

   <requiredRuntime  
version="runtime version"
safemode="true|false"/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	Beschreibung
`version`	Optionales Attribut. Ein Zeichenfolgenwert, der das .NET Framework angibt, das diese Anwendung unterstützt. Der Zeichenfolgenwert muss mit dem Verzeichnisnamen übereinstimmen, der sich im .NET Framework-Installationsstamm befindet. Der Inhalt des Zeichenfolgenwerts wird nicht analysiert.
`safemode`	Optionales Attribut. Gibt an, ob der Startcode der Runtime die Registrierung durchsucht, um die Runtimeversion zu ermitteln.

safemode-Attribut

Wert	BESCHREIBUNG
`false`	Der Startcode der Runtime durchsucht die Registrierung. Dies ist der Standardwert.
`true`	Der Startcode der Runtime durchsucht die Registrierung nicht.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`startup`	Enthält das `<requiredRuntime>`-Element.

Bemerkungen

Anwendungen, die nur Version 1.0 der Runtime unterstützen, müssen das <requiredRuntime>-Element verwenden. Anwendungen, die Version 1.1 oder höher der Runtime unterstützen, müssen das <supportedRuntime>-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.

Die version-Attributzeichenfolge muss mit dem Installationsordnernamen für die angegebene Version des .NET Framework übereinstimmen. Die Zeichenfolge wird nicht interpretiert. Wenn der Startcode der Runtime keinen übereinstimmenden Ordner findet, wird die Runtime nicht geladen. Der Startcode zeigt eine Fehlermeldung an und wird beendet.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie die Runtimeversion in einer Konfigurationsdatei angeben.

<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>