FileSecurity 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
初始化 FileSecurity 类的新实例。
重载
| FileSecurity() |
初始化 FileSecurity 类的新实例。 |
| FileSecurity(String, AccessControlSections) |
使用 AccessControlSections 枚举的指定值从指定文件中初始化 FileSecurity 类的新实例。 |
FileSecurity()
初始化 FileSecurity 类的新实例。
public:
FileSecurity();public FileSecurity();Public Sub New ()例外
当前操作系统未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.FileSecurityPublic Sub New (fileName As String, includeSections As AccessControlSections)参数
- fileName
- String
要从中创建 FileSecurity 对象的文件的位置。
- includeSections
- AccessControlSections
AccessControlSections 值之一，指定要检索的访问控制列表（ACL）信息的类型。
例外
fileName 参数是长度为零的字符串，仅包含空格，或包含一个或多个由 InvalidPathChars定义的无效字符。
指定的路径无效（例如，它位于未映射的驱动器上）。
找不到 fileName 参数中指定的文件。
打开文件时出现 I/O 错误。
path 格式无效。
fileName 参数 null。
当前操作系统未Microsoft Windows 2000 或更高版本。
指定的路径、文件名或两者都超过了系统定义的最大长度。
当前系统帐户没有管理权限。
找不到该文件。
fileName 参数指定了只读文件。
-或-
当前平台上不支持此操作。
-或-
fileName 参数指定了目录。
-或-
调用方没有所需的权限。
注解
此构造函数检索指定文件的访问控制信息，然后创建封装该信息的 FileSecurity 对象。 然后，可以检查、添加或删除指定文件的访问控制信息。
可以使用 AddAccessRule 方法向 FileSecurity 对象添加访问或审核规则。 可以使用 RemoveAccessRule 方法删除访问或审核规则。
调用方说明
FileSecurity(String, AccessControlSections) 构造函数要求当前帐户具有管理权限。 若要使用没有管理权限的帐户为特定文件创建 FileSecurity 类的新实例，请使用 GetAccessControl() 方法。
