File.GetAccessControl 方法

参考

定义

命名空间:: System.IO

程序集:: mscorlib.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取一个 FileSecurity 对象，该对象封装指定文件的访问控制列表（ACL）条目。

重载

GetAccessControl(String, AccessControlSections)	获取一个 FileSecurity 对象，该对象封装特定文件的指定类型的访问控制列表（ACL）条目。
GetAccessControl(String)	获取一个 FileSecurity 对象，该对象封装指定文件的访问控制列表（ACL）条目。

GetAccessControl(String, AccessControlSections)

获取一个 FileSecurity 对象，该对象封装特定文件的指定类型的访问控制列表（ACL）条目。

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

参数

path: String

文件的路径，其中包含描述文件的访问控制列表（ACL）信息的 FileSecurity 对象。

includeSections: AccessControlSections

指定要接收的访问控制列表（ACL）信息的 AccessControlSections 值之一。

FileSecurity

一个 FileSecurity 对象，该对象封装 path 参数描述的文件的访问控制规则。

例外

IOException

打开文件时出现 I/O 错误。

SEHException

path 参数 null。

SystemException

找不到该文件。

UnauthorizedAccessException

path 参数指定了只读文件。

-或-

当前平台上不支持此操作。

-或-

path 参数指定了目录。

-或-

调用方没有所需的权限。

注解

使用 GetAccessControl 方法检索文件的访问控制列表（ACL）条目。

ACL 描述对给定文件执行特定操作或无权执行的人员和组。有关详细信息，请参阅如何：添加或删除访问控制列表项。

在 NTFS 环境中，如果用户对父文件夹具有 ListDirectory 权限，则向用户授予 ReadAttributes 和 ReadExtendedAttributes。若要拒绝 ReadAttributes 和 ReadExtendedAttributes，请拒绝父目录上的 ListDirectory。

适用于

GetAccessControl(String)