EnvironmentPermissionAttribute-Klasse
Lässt zu, dass Sicherheitsaktionen für EnvironmentPermission mithilfe der Deklarationssicherheit auf Code angewendet werden. Diese Klasse kann nicht vererbt werden.
Namespace: System.Security.Permissions
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class Or AttributeTargets.Struct Or AttributeTargets.Constructor Or AttributeTargets.Method, AllowMultiple:=True, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class EnvironmentPermissionAttribute
Inherits CodeAccessSecurityAttribute
'Usage
Dim instance As EnvironmentPermissionAttribute
[SerializableAttribute]
[AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple=true, Inherited=false)]
[ComVisibleAttribute(true)]
public sealed class EnvironmentPermissionAttribute : CodeAccessSecurityAttribute
[SerializableAttribute]
[AttributeUsageAttribute(AttributeTargets::Assembly|AttributeTargets::Class|AttributeTargets::Struct|AttributeTargets::Constructor|AttributeTargets::Method, AllowMultiple=true, Inherited=false)]
[ComVisibleAttribute(true)]
public ref class EnvironmentPermissionAttribute sealed : public CodeAccessSecurityAttribute
/** @attribute SerializableAttribute() */
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple=true, Inherited=false) */
/** @attribute ComVisibleAttribute(true) */
public final class EnvironmentPermissionAttribute extends CodeAccessSecurityAttribute
SerializableAttribute
AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple=true, Inherited=false)
ComVisibleAttribute(true)
public final class EnvironmentPermissionAttribute extends CodeAccessSecurityAttribute
Hinweise
Der zulässige Gültigkeitsbereich der Deklaration hängt von der verwendeten SecurityAction ab.
Die von einem Sicherheitsattribut deklarierten Sicherheitsinformationen werden in den Metadaten des Attributzieles gespeichert. Das System greift auf diese Sicherheitsinformationen zur Laufzeit zu. Sicherheitsattribute werden ausschließlich für deklarative Sicherheit verwendet. Verwenden Sie für imperative Sicherheit die entsprechende Berechtigungsklasse.
Bei Namen von Umgebungsvariablen wird die Groß- und Kleinschreibung nicht berücksichtigt. Bei Angabe mehrerer Namen von Umgebungsvariablen werden die Namen mit PathSeparator getrennt.
Beispiel
Im folgenden Beispiel eines deklarativen Attributs wird dargestellt, auf welche Weise EnvironmentPermission zum Lesen der angegebenen Umgebungsvariablen ordnungsgemäß angefordert wird, und die Anweisung erteilt, dass Sie zum Ausführen des Codes mindestens über diese Berechtigung verfügen müssen.
<Assembly: EnvironmentPermissionAttribute(SecurityAction.RequestMinimum, _
Read := "COMPUTERNAME;USERNAME;USERDOMAIN")>
'In Visual Basic, you must specify that you are using the assembly scope when making a request.
[assembly:EnvironmentPermissionAttribute(SecurityAction.RequestMinimum,
Read="COMPUTERNAME;USERNAME;USERDOMAIN")]
//In C#, you must specify that you are using the assembly scope when making a request.
[assembly:EnvironmentPermissionAttribute(SecurityAction::RequestMinimum,
Read="COMPUTERNAME;USERNAME;USERDOMAIN")];
//In C++, you must specify that you are using the assembly scope when making a request.
/** @assembly EnvironmentPermissionAttribute(SecurityAction.RequestMinimum,
Read = "COMPUTERNAME;USERNAME;USERDOMAIN")
*/
// In VJ#, you must specify that you are using the assembly scope when
// making a request.
Im folgenden Beispiel wird veranschaulicht, wie gefordert wird, dass der Aufrufcode zur Verknüpfungszeit über EnvironmentPermission verfügt. Anforderungen werden i. d. R. in verwalteten Bibliotheken (DLLs) vorgenommen, um Methoden und Klassen vor möglicherweise böswilligem Code zu schützen.
<EnvironmentPermission(SecurityAction.Demand, Unrestricted := True)> _
Public Class SampleClass
[EnvironmentPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]
[EnvironmentPermissionAttribute(SecurityAction::Demand,Unrestricted=true)]
/** @attribute EnvironmentPermissionAttribute(SecurityAction.Demand,
Unrestricted = true)
*/
Vererbungshierarchie
System.Object
System.Attribute
System.Security.Permissions.SecurityAttribute
System.Security.Permissions.CodeAccessSecurityAttribute
System.Security.Permissions.EnvironmentPermissionAttribute
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
EnvironmentPermissionAttribute-Member
System.Security.Permissions-Namespace
EnvironmentPermission-Klasse
EnvironmentPermissionAccess-Enumeration