Teilen über


<requiredRuntime>-Element

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>

Siehe auch