<startup>-Element

  • Artikel

Gibt Informationen zum Starten der Common Language Runtime an.

<configuration>
  <startup>

Syntax

<startup useLegacyV2RuntimeActivationPolicy="true|false" >
</startup>

Attribute und Elemente

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

Attribute

attribute Beschreibung
useLegacyV2RuntimeActivationPolicy Optionales Attribut.

Gibt an, ob die .NET Framework 2.0-Laufzeitaktivierungsrichtlinie aktiviert oder die .NET Framework 4-Aktivierungsrichtlinie verwendet werden soll.

useLegacyV2RuntimeActivationPolicy-Attribut

Wert Beschreibung
true Aktivieren Sie die .NET Framework 2.0-Laufzeitaktivierungsrichtlinie für die gewählte Runtime, d. h. binden Sie Legacy-Laufzeitaktivierungstechniken (wie die Funktion CorBindToRuntimeEx) an die aus der Konfigurationsdatei gewählte Runtime, anstatt sie auf die CLR-Version 2.0 zu begrenzen. Wenn also in der Konfigurationsdatei die CLR-Version 4 oder höher ausgewählt wird, werden Assemblys im gemischten Modus, die mit früheren Versionen des .NET Framework erstellt wurden, mit der gewählten CLR-Version geladen. Wenn Sie diesen Wert festlegen, wird verhindert, dass die CLR-Version 1.1 oder die CLR-Version 2.0 in denselben Prozess geladen wird, wodurch das parallele In-Process-Feature effektiv deaktiviert wird.
false Verwenden Sie die Standardaktivierungsrichtlinie von .NET Framework 4 und höher, d. h., dass Sie Legacy-Laufzeitaktivierungstechniken zulassen, um die CLR-Version 1.1 oder 2.0 in den Prozess zu laden. Wenn Sie diesen Wert festlegen, können Assemblys im gemischten Modus nur dann in .NET Framework 4 oder höher geladen werden, wenn sie mit .NET Framework 4 oder höher erstellt wurden. Dies ist der Standardwert.

Untergeordnete Elemente

Element Beschreibung
<requiredRuntime> Gibt an, dass die Anwendung nur Version 1.0 der Common Language Runtime unterstützt. Anwendungen, die mit Version 1.1 oder höher der Runtime erstellt wurden, sollten das <supportedRuntime>-Element verwenden.
<supportedRuntime> Gibt an, welche Versionen der Common Language Runtime von der Anwendung unterstützt werden.

Übergeordnete Elemente

Element BESCHREIBUNG
configuration Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.

Hinweise

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.

useLegacyV2RuntimeActivationPolicy-Attribut

Dieses Attribut ist hilfreich, wenn Ihre Anwendung Legacy-Aktivierungspfade verwendet, z. B. die CorBindToRuntimeEx-Funktion, und Sie möchten, dass diese Pfade Version 4 der CLR anstelle von einer früheren Version aktivieren, oder wenn Ihre Anwendung mit .NET Framework 4 erstellt wurde, aber eine Abhängigkeit auf eine gemischte Assembly hat, die mit einer früheren Version von .NET Framework erstellt wurde. Legen Sie in diesen Szenarien das Attribut auf true fest.

Hinweis

Wenn Sie das Attribut auf true festlegen, wird verhindert, dass die CLR-Version 1.1 oder 2.0 in denselben Prozess geladen wird, wodurch das parallele In-Process-Feature deaktiviert wird (siehe Parallele Ausführung für COM-Interop).

Beispiel

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

<!-- When used with version 1.0 of the .NET Framework runtime -->
<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>
<!-- When used with version 1.1 (or later) of the runtime -->
<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

Siehe auch