FileSecurity 构造函数

定义

命名空间:

System.Security.AccessControl

程序集:

System.IO.FileSystem.AccessControl.dll

初始化 FileSecurity 类的新实例。

重载

FileSecurity()	初始化 FileSecurity 类的新实例。
FileSecurity(String, AccessControlSections)	使用 FileSecurity 枚举的指定值从指定文件初始化 AccessControlSections 类的新实例。

FileSecurity()

初始化 FileSecurity 类的新实例。

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

例外

PlatformNotSupportedException

当前操作系统不是 Microsoft Windows 2000 或更高版本。

注解

如果要创建不基于现有文件的空 FileSecurity 对象，请使用此构造函数。 然后，可以使用访问控制信息填充对象，并将其应用于文件。

可以使用 方法向 FileSecurity 对象 AddAccessRule 添加访问或审核规则。 可以使用 方法删除访问或审核规则 RemoveAccessRule 。

若要将新的或更改的访问权限或审核规则保存到文件，请使用 SetAccessControl 或 SetAccessControl 方法。 若要从现有文件中检索访问或审核规则，请使用 GetAccessControl 或 GetAccessControl 方法。

FileSecurity(String, AccessControlSections)

使用 FileSecurity 枚举的指定值从指定文件初始化 AccessControlSections 类的新实例。

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

new System.Security.AccessControl.FileSecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Sub New (fileName As String, includeSections As AccessControlSections)

参数

fileName

String

一个文件的位置，FileSecurity 对象将从该文件创建。

includeSections

AccessControlSections

AccessControlSections 值之一，该值指定要检索的访问控制列表 (ACL) 信息的类型。

例外

ArgumentException

fileName 参数为长度为零的字符串，仅包含空格，或包含一个或多个由 InvalidPathChars 定义的无效字符。

DirectoryNotFoundException

指定的路径无效（例如，它位于未映射的驱动器上）。

FileNotFoundException

未找到 fileName 参数中所指定的文件。

IOException

打开文件时发生 I/O 错误。

NotSupportedException

path 的格式无效。

SEHException

fileName 参数为 null。

PlatformNotSupportedException

当前操作系统不是 Microsoft Windows 2000 或更高版本。

PathTooLongException

指定的路径和/或文件名超过了系统定义的最大长度。

PrivilegeNotHeldException

当前的系统帐户没有管理权限。

SystemException

找不到文件。

UnauthorizedAccessException

fileName 参数指定了一个只读文件。

- 或 -

当前平台不支持此操作。

- 或 -

fileName 参数指定了一个目录。

- 或 -

调用方没有所要求的权限。

注解

此构造函数检索指定文件的访问控制信息，然后创建封装 FileSecurity 该信息的 对象。 然后，可以检查、添加或删除指定文件的访问控制信息。

可以使用 方法向 FileSecurity 对象 AddAccessRule 添加访问或审核规则。 可以使用 方法删除访问或审核规则 RemoveAccessRule 。

若要将新的或更改的访问权限或审核规则保存到文件，请使用 SetAccessControl 或 SetAccessControl 方法。 若要从现有文件中检索访问或审核规则，请使用 GetAccessControl 或 GetAccessControl 方法。

调用方说明

构造 FileSecurity(String, AccessControlSections) 函数要求当前帐户具有管理权限。 若要使用不具有管理权限的 FileSecurity 帐户为特定文件创建 类的新实例，请使用 GetAccessControl() 方法。