<NetFx40_LegacySecurityPolicy>-Element

  • Artikel

Gibt an, ob die Runtime die Legacyrichtlinie für Code Access Security (CAS) verwendet.

<configuration>
  <runtime>
    <NetFx40_LegacySecurityPolicy>

Hinweis

Die Codezugriffssicherheit (CAS, Code Access Security) ist in allen Versionen von .NET Framework und .NET veraltet. Aktuelle Versionen von .NET berücksichtigen keine CAS-Anmerkungen und erzeugen Fehler, wenn CAS-bezogene APIs verwendet werden. Entwickler*innen sollten alternative Mittel zum Ausführen von Sicherheitsaufgaben suchen.

Syntax

<NetFx40_LegacySecurityPolicy
   enabled="true|false"/>

Attribute und Elemente

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

Attribute

attribute Beschreibung
enabled Erforderliches Attribut.

Gibt an, ob die Runtime eine CAS-Legacyrichtlinie verwendet.

Enabled-Attribut

Wert BESCHREIBUNG
false Die Runtime verwendet keine CAS-Legacyrichtlinie. Dies ist die Standardoption.
true Die Runtime verwendet eine CAS-Legacyrichtlinie.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element BESCHREIBUNG
configuration Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
runtime Enthält Informationen über Laufzeitinitialisierungsoptionen.

Bemerkungen

In der .NET Framework-Version 3.5 und früheren Versionen ist die CAS-Richtlinie immer aktiviert. In .NET Framework 4 muss die CAS-Richtlinie aktiviert werden.

Die CAS-Richtlinie ist versionsspezifisch. Benutzerdefinierte CAS-Richtlinien, die in früheren Versionen des .NET Framework vorhanden sind, müssen in .NET Framework 4 erneut angegeben werden.

Das Anwenden des <NetFx40_LegacySecurityPolicy>-Elements auf eine .NET Framework 4-Assembly wirkt sich nicht auf sicherheitstransparenten Code aus. Die Transparenzregeln gelten weiterhin.

Wichtig

Das Anwenden des <NetFx40_LegacySecurityPolicy>-Elements kann zu erheblichen Leistungseinbußen für native Imageassemblys führen, die vom Native Image Generator (Ngen.exe) erstellt wurden und nicht im globalen Assemblycache installiert sind. Die Leistungsbeeinträchtigung wird durch die Unfähigkeit der Runtime verursacht, die Assemblys als native Images zu laden, wenn das Attribut angewendet wird, was dazu führt, dass sie als Just-In-Time (JIT)-Assemblys geladen werden.

Hinweis

Wenn Sie in den Projekteinstellungen für Ihr Visual Studio-Projekt eine .NET Framework-Zielversion angeben, die niedriger als .NET Framework 4 ist, wird die CAS-Richtlinie aktiviert, einschließlich aller benutzerdefinierten CAS-Richtlinien, die Sie für diese Version angegeben haben. Sie können jedoch keine neuen .NET Framework 4-Typen und -Member verwenden. Sie können auch eine frühere Version des .NET Framework angeben, indem Sie das <supportedRuntime>-Element im Starteinstellungsschema in Ihrer Anwendungskonfigurationsdatei verwenden.

Hinweis

Bei der Syntax der Konfigurationsdatei wird die Groß-/Kleinschreibung beachtet. Sie sollten die Syntax verwenden, wie in den Abschnitten „Syntax“ und „Beispiel“ angegeben.

Konfigurationsdatei

Dieses Element kann nur in der Anwendungskonfigurationsdatei verwendet werden.

Beispiel

Das folgende Beispiel zeigt, wie diese CAS-Legacyrichtlinie für eine Anwendung aktiviert wird.

<configuration>
   <runtime>
      <NetFx40_LegacySecurityPolicy enabled="true"/>
   </runtime>
</configuration>

Siehe auch