FileIOPermissionAttribute 类

定义

命名空间:

System.Security.Permissions

程序集:

System.Security.Permissions.dll

包:

System.Security.Permissions v9.0.0-preview.5.24306.7

Source:

FileIOPermissionAttribute.cs

注意

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)]
[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.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

Public NotInheritable Class FileIOPermissionAttribute
Inherits CodeAccessSecurityAttribute

继承

Object

Attribute

SecurityAttribute

CodeAccessSecurityAttribute

FileIOPermissionAttribute

属性

AttributeUsageAttribute ObsoleteAttribute

示例

下面的代码示例演示如何使用 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。

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

谨慎

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

构造函数

FileIOPermissionAttribute(SecurityAction)

已过时. 使用指定的 SecurityAction初始化 FileIOPermissionAttribute 类的新实例。

属性

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)

另请参阅

• FileIOPermission
• FileIOPermissionAccess
• 使用属性 扩展元数据