<startup>-Element

  • Artikel

Gibt Common Language Runtime-Startinformationen an.

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

Attribute und Elemente

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

Attribute

Attribute

Beschreibungen

useLegacyV2RuntimeActivationPolicy

Optionales Attribut.

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

useLegacyV2RuntimeActivationPolicy-Attribut

Value

Beschreibungen

true

Aktivieren Sie die .NET Framework, Version 2.0-Laufzeitaktivierungsrichtlinie für die gewählte Laufzeit, die ältere Laufzeitaktivierungstechniken (z. B. die 99sz37yh(v=vs.100).mdCorBindToRuntimeEx-Funktion) an die Laufzeit bindet, die aus der Konfigurationsdatei ausgewählt wurde, anstatt sie auf CLR-Version 2.0 zu begrenzen. Daher, wenn CLR-Version 4 oder höher von der Konfigurationsdatei gewählt ist, werden Gemischter-Modus-Assemblys, die mit früheren Versionen von .NET Framework erstellt wurden, mit der gewählten Version der CLR geladen. Das Festlegen dieses Werts verhindert, dass CLR-Version 1.1 oder CLR-Version 2.0 in den gleichen Prozess lädt, und deaktiviert effektiv die prozessinterne Parallelfunktion.

false

Verwenden Sie die Standardaktivierungsrichtlinie für .NET Framework 4 und höher, wodurch ältere Laufzeitaktivierungstechniken zum Laden der CLR-Version 1.1 oder 2.0 in den Prozess ermöglicht werden. Das Festlegen dieses Wertes verhindert, dass gemischte Assemblys in .NET Framework 4 oder höher geladen werden, es sei denn, sie wurden mit .NET Framework 4 oder höher erstellt. Dieser Wert ist die Standardeinstellung.

Untergeordnete Elemente

Element

Beschreibungen

<requiredRuntime>

Gibt an, dass die Anwendung lediglich Version 1.0 der Common Language Runtime unterstützt. Anwendungen, die mit Laufzeitversion 1.1 oder höher 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

Beschreibungen

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 späteren Version der Laufzeit erstellt wurden. Anwendungen, die nur Version 1.0 der Laufzeit unterstützen, müssen das <requiredRuntime>-Element verwenden.

Hinweis   Der Startcode für eine Anwendung, deren Host Microsoft Internet Explorer ist, ignoriert das <startup>-Element.

Das useLegacyV2RuntimeActivationPolicy-Attribut

Dieses Attribut ist hilfreich, wenn Ihre Anwendung ältere 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 von einer Gemischter-Modus-Assembly hat, die mit einer früheren Version von .NET Framework erstellt wurde. Legen Sie in diesen Szenarien das Attribut auf true fest.

HinweisHinweis

Das Festlegen des Attributs auf true verhindert, dass CLR-Version 1.1 oder CLR-Version 2.0 in den gleichen Prozess lädt, und deaktiviert effektiv die prozessinterne Parallelfunktion (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

Referenz

Schema für Starteinstellungen

Konzepte

Festlegen der zu verwendenden Version von Common Language Runtime

Weitere Ressourcen

Konfigurationsdateischema für .NET Framework

Parallele Ausführung für COM-Interop

Prozessinterne parallele Ausführung