File.GetAccessControl 方法

定义

命名空间:: System.IO

程序集:: mscorlib.dll

重要

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

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

重载

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

GetAccessControl(String)

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

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

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

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

Public Shared Function GetAccessControl (path As String) As FileSecurity

参数

path: String

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

FileSecurity

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

例外

IOException

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

SEHException

参数 path 为 null.

SystemException

找不到该文件。

UnauthorizedAccessException

参数 path 指定了只读文件。

-或-

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

-或-

参数 path 指定了目录。

-或-

调用方没有所需的权限。

注解

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

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

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

适用于

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