EnvironmentPermissionAttribute 类

允许对使用声明安全性应用到代码中的 EnvironmentPermission 进行安全操作。无法继承此类。

**命名空间:**System.Security.Permissions
**程序集:**mscorlib(在 mscorlib.dll 中)

语法

声明
<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
用法
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

备注

允许的声明范围取决于使用的 SecurityAction

安全属性所声明的安全信息存储在属性目标的元数据中,系统在运行时会访问这些信息。安全属性仅用于声明性安全。对于强制性安全,应使用相应的权限类。

环境变量名称不区分大小写。多个环境变量名称通过用 PathSeparator 分隔各个名称来进行指定。

示例

下面的声明属性示例显示请求 EnvironmentPermission 的正确方法,以便能够读取指定的环境变量,并声明您必须至少拥有此权限方可运行代码。

<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.

下面的示例显示如何要求调用代码在链接时拥有 EnvironmentPermission。通常在托管库 (DLL) 中发出请求,以帮助保护方法或类不受潜在的有害代码的影响。

<EnvironmentPermission(SecurityAction.Demand, Unrestricted := True)> _
 Public Class SampleClass 
[EnvironmentPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]
[EnvironmentPermissionAttribute(SecurityAction::Demand,Unrestricted=true)]
/** @attribute EnvironmentPermissionAttribute(SecurityAction.Demand,
    Unrestricted = true)
 */

继承层次结构

System.Object
   System.Attribute
     System.Security.Permissions.SecurityAttribute
       System.Security.Permissions.CodeAccessSecurityAttribute
        System.Security.Permissions.EnvironmentPermissionAttribute

线程安全

此类型的任何公共静态(Visual Basic 中的 Shared)成员都是线程安全的,但不保证所有实例成员都是线程安全的。

平台

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 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

请参见

参考

EnvironmentPermissionAttribute 成员
System.Security.Permissions 命名空间
EnvironmentPermission 类
EnvironmentPermissionAccess 枚举

其他资源

利用属性扩展元数据