FileIOPermissionAttribute 类

定义

注意

Code Access Security is not supported or honored by the runtime.

允许对要使用声明性安全应用到代码中的 FileIOPermission 执行安全操作。 此类不能被继承。

public ref class FileIOPermissionAttribute sealed : System::Security::Permissions::CodeAccessSecurityAttribute
[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
public sealed class FileIOPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute
[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class FileIOPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute
[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[System.Serializable]
public sealed class FileIOPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute
[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class FileIOPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute
[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
type FileIOPermissionAttribute = class
    inherit CodeAccessSecurityAttribute
[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type FileIOPermissionAttribute = class
    inherit CodeAccessSecurityAttribute
[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
[<System.Serializable>]
type FileIOPermissionAttribute = class
    inherit CodeAccessSecurityAttribute
[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileIOPermissionAttribute = class
    inherit CodeAccessSecurityAttribute
Public NotInheritable Class FileIOPermissionAttribute
Inherits CodeAccessSecurityAttribute
继承
属性

示例

下面的代码示例演示如何使用 FileIOPermissionAttribute 类请求FileIOPermission,指示要授予代码的唯一权限。

[FileIOPermissionAttribute(SecurityAction::PermitOnly,ViewAndModify="C:\\example\\sample.txt")]
[FileIOPermissionAttribute(SecurityAction.PermitOnly, ViewAndModify = "C:\\example\\sample.txt")]
<FileIOPermissionAttribute(SecurityAction.PermitOnly, _
ViewAndModify:="C:\example\sample.txt")> Public Class SampleClass

以下示例演示如何要求调用代码具有不受限制 FileIOPermission的 。 通常,在托管库 (DLL) 中提出要求,以帮助保护方法或类免受潜在有害代码的侵害。

[FileIOPermissionAttribute(SecurityAction::Demand,Unrestricted=true)]
[FileIOPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]
<FileIOPermissionAttribute(SecurityAction.Demand, _
 Unrestricted := True)> Public Class SampleClass

注解

注意

代码访问安全性 (CAS) 已在所有版本的 .NET Framework 和 .NET 中弃用。 如果使用与 CAS 相关的 API,最新版本的 .NET 不会遵循 CAS 注释,并会生成错误。 开发人员应寻求使用替代方法来完成安全任务。

文件和目录是使用绝对路径指定的。 访问文件时,创建或打开文件时会执行安全检查。 除非文件已关闭并重新打开,否则不会再次执行安全检查。 首次访问文件时检查权限可以最大程度地减少安全检查对应用程序性能的影响,因为打开文件只会发生一次,而读取和写入可能会多次发生。

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

安全属性声明的安全信息存储在属性目标的元数据中,并由系统在运行时进行访问。 安全属性仅用于声明性安全性。 为了获得命令性安全性,请使用相应的权限类。

注意

UnrestrictedFileIOPermission 授予对文件系统内所有路径的权限,包括可用于访问单个给定文件的多个路径名。 若要 Deny 访问文件,必须 Deny 具有文件的所有可能路径。 例如,如果 \\server\share 映射到网络驱动器 X,若要 Deny 访问 \\server\share\file,则必须 Deny \\server\share\file、X:\file 以及可用于访问该文件的任何其他路径。

构造函数

FileIOPermissionAttribute(SecurityAction)
已过时.

使用指定的 FileIOPermissionAttribute 初始化 SecurityAction 类的新实例。

属性

Action
已过时.

获取或设置安全性操作。

(继承自 SecurityAttribute)
All
已过时.
已过时.
已过时.

获取或设置对字符串值所指定的文件或目录的完全访问权限。

AllFiles
已过时.

获取或设置对所有文件的允许访问权限。

AllLocalFiles
已过时.

获取或设置对所有本地文件的允许访问权限。

Append
已过时.

获取或设置对字符串值所指定的文件或目录的追加访问权限。

ChangeAccessControl
已过时.

获取或设置可在其中更改访问控制信息的文件或目录。

PathDiscovery
已过时.

获取或设置针对其授予路径发现权限的文件或目录。

Read
已过时.

获取或设置对字符串值所指定的文件或目录的读访问权限。

TypeId
已过时.

在派生类中实现时,获取此 Attribute 的唯一标识符。

(继承自 Attribute)
Unrestricted
已过时.

获取或设置一个值,该值指示是否声明了对受该特性保护的资源有完全(无限制的)权限。

(继承自 SecurityAttribute)
ViewAccessControl
已过时.

获取或设置可在其中查看访问控制信息的文件或目录。

ViewAndModify
已过时.

获取或设置可在其中查看并修改文件数据的文件或目录。

Write
已过时.

获取或设置对字符串值所指定的文件或目录的写访问权限。

方法

CreatePermission()
已过时.

创建并返回一个新的 FileIOPermission

Equals(Object)
已过时.

返回一个值,该值指示此实例是否与指定的对象相等。

(继承自 Attribute)
GetHashCode()
已过时.

返回此实例的哈希代码。

(继承自 Attribute)
GetType()
已过时.

获取当前实例的 Type

(继承自 Object)
IsDefaultAttribute()
已过时.

在派生类中重写时,指示此实例的值是否是派生类的默认值。

(继承自 Attribute)
Match(Object)
已过时.

当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。

(继承自 Attribute)
MemberwiseClone()
已过时.

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()
已过时.

返回表示当前对象的字符串。

(继承自 Object)

显式接口实现

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)
已过时.

将一组名称映射为对应的一组调度标识符。

(继承自 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)
已过时.

检索对象的类型信息,然后可以使用该信息获取接口的类型信息。

(继承自 Attribute)
_Attribute.GetTypeInfoCount(UInt32)
已过时.

检索对象提供的类型信息接口的数量(0 或 1)。

(继承自 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)
已过时.

提供对某一对象公开的属性和方法的访问。

(继承自 Attribute)

适用于

另请参阅