FileSecurity 构造函数

定义

命名空间:

System.Security.AccessControl

程序集:

System.IO.FileSystem.AccessControl.dll

初始化 FileSecurity 类的新实例。

重载

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

FileSecurity()

初始化 FileSecurity 类的新实例。

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

例外

PlatformNotSupportedException

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

注解

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

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

FileSecurity(String, AccessControlSections)

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

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 对象。 然后，可以检查、添加或删除指定文件的访问控制信息。

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

调用方说明

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