SuppressUnmanagedCodeSecurityAttribute Klasse

Definition

Namespace:

System.Security

Assembly:

System.Runtime.dll

Quelle:

SuppressUnmanagedCodeSecurityAttribute.cs

Ermöglicht es verwaltetem Code, nicht verwalteten Code ohne Stackwalk aufzurufen. Diese Klasse kann nicht vererbt werden.

public ref class SuppressUnmanagedCodeSecurityAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Delegate | System.AttributeTargets.Interface | System.AttributeTargets.Method, AllowMultiple=true, Inherited=false)]
public sealed class SuppressUnmanagedCodeSecurityAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Delegate | System.AttributeTargets.Interface | System.AttributeTargets.Method, AllowMultiple=true, Inherited=false)>]
type SuppressUnmanagedCodeSecurityAttribute = class
    inherit Attribute

Public NotInheritable Class SuppressUnmanagedCodeSecurityAttribute
Inherits Attribute

Vererbung

Object

Attribute

SuppressUnmanagedCodeSecurityAttribute

Attribute

AttributeUsageAttribute

Hinweise

Wichtig

Teilweise vertrauenswürdiger Code wird nicht mehr unterstützt. Dieses Attribut hat keine Auswirkungen in .NET Core.

Achtung

Verwenden Sie dieses Attribut mit äußerster Sorgfalt. Eine falsche Verwendung kann zu Sicherheitsschwächen führen.

Dieses Attribut kann auf Methoden angewendet werden, die systemeigenen Code aufrufen möchten, ohne dass dabei der Leistungsverlust einer Laufzeitsicherheitsprüfung entsteht. Der Stapellauf, der beim Aufrufen von nicht verwaltetem Code ausgeführt wird, wird zur Laufzeit weggelassen, was zu erheblichen Leistungseinsparungen führt. Wenn Sie dieses Attribut in einer Klasse verwenden, wird es auf alle enthaltenen Methoden angewendet.

Im Allgemeinen wird bei jedem Aufruf von verwaltetem Code in nicht verwalteten Code (durch PInvoke oder COM-Interop in nativen Code) die UnmanagedCode Berechtigung benötigt, um sicherzustellen, dass alle Aufrufer über die erforderliche Berechtigung verfügen, dies zuzulassen. Durch Anwenden dieses expliziten Attributs können Entwickler den Bedarf zur Laufzeit unterdrücken. Der Entwickler muss dafür verantwortlich sein, sicherzustellen, dass der Übergang in nicht verwalteten Code mit anderen Mitteln ausreichend geschützt ist. Die Anforderung für die UnmanagedCode Berechtigung tritt weiterhin zum Linkzeitpunkt auf. Wenn beispielsweise Funktion A Funktion B aufruft und Funktion B mit SuppressUnmanagedCodeSecurityAttributegekennzeichnet ist, wird Funktion A während der Just-in-Time-Kompilierung auf nicht verwalteten Code überprüft, aber nicht später während der Laufzeit.

Dieses Attribut ist nur wirksam, wenn es auf PInvoke-Methoden (oder -Klassen, die PInvoke-Methoden enthalten) oder die Definition einer Schnittstelle angewendet wird, über die Interopaufrufe erfolgen. Sie wird in allen anderen Kontexten ignoriert.

Dieses Attribut ist nützlich für die Implementierung einer Klasse, die den Zugriff auf Systemressourcen über nicht verwalteten Code ermöglicht. Code, der nicht über die Berechtigung für den Zugriff auf nicht verwalteten Code verfügt, kann eine Klasse mit diesem Attribut aufrufen, um auf nicht verwalteten Code zuzugreifen. Dies ist nur sicher, wenn der Writer der Klasse mit diesem Attribut die Klasse so programmiert hat, dass sie sicher ist. Andernfalls ist dieses Attribut gefährlich und kann es zulassen, dass der Code, der es verwendet, missbraucht wird.

Dies ist kein deklaratives Sicherheitsattribute, sondern ein reguläres Attribut (es wird von Attributeabgeleitet, nicht SecurityAttribute).

Konstruktoren

SuppressUnmanagedCodeSecurityAttribute()

Initialisiert eine neue Instanz der SuppressUnmanagedCodeSecurityAttribute-Klasse.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Erweitern von Metadaten mithilfe von Attributen