System.IO.FileStream.SetAccessControl 方法

方法描述

将 FileSecurity 对象所描述的访问控制列表 (ACL) 项应用于当前 FileStream 对象所描述的文件。

语法定义(C# System.IO.FileStream.SetAccessControl 方法 的用法)

public void SetAccessControl(
	FileSecurity fileSecurity
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
fileSecurity System-Security-AccessControl-FileSecurity 描述要应用于当前文件的 ACL 项的对象。
返回值 void

提示和注释

当可以对现有文件使用 FileStream 类和 SetAccessControl 时,请考虑使用 File.SetAccessControl 方法,因为它的操作更简便。

SetAccessControl 方法将访问控制列表 (ACL) 项应用于表示非继承 ACL 列表的文件。

警告

为 fileSecurity 参数指定的 ACL 替换该文件的现有 ACL。 若要为新用户添加权限,请使用 GetAccessControl 方法获取现有的 ACL 并对其进行修改,然后使用 SetAccessControl 将其重新应用于此文件。

ACL 描述对给定文件具有或没有执行特定操作的权限的个人和(或)组。 有关更多信息,请参见ACL 技术概述和如何:添加或移除访问控制列表项。

System.IO.FileStream.SetAccessControl 方法例子


异常

异常 异常描述
ObjectDisposedException 文件被关闭。
ArgumentNullException fileSecurity 参数为 null。
SystemException 未能找到或修改文件。
UnauthorizedAccessException 当前进程不具有打开该文件的权限。

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。