FileSecurity 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
初始化 FileSecurity 类的新实例。
重载
| 名称 | 说明 |
|---|---|
| FileSecurity() |
初始化 FileSecurity 类的新实例。 |
| FileSecurity(String, AccessControlSections) |
使用枚举的FileSecurity指定值从指定文件中初始化类的新实例AccessControlSections。 |
FileSecurity()
初始化 FileSecurity 类的新实例。
public:
FileSecurity();public FileSecurity();Public Sub New ()例外
当前操作系统未Microsoft Windows 2000 或更高版本。
注解
如果要创建不基于现有文件的空 FileSecurity 对象，请使用此构造函数。 然后，可以使用访问控制信息填充对象并将其应用于文件。
可以使用该方法向 FileSecurity 对象 AddAccessRule 添加访问或审核规则。 可以使用该方法 RemoveAccessRule 删除访问或审核规则。
适用于
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.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 该信息的对象。 然后，可以检查、添加或删除指定文件的访问控制信息。
可以使用该方法向 FileSecurity 对象 AddAccessRule 添加访问或审核规则。 可以使用该方法 RemoveAccessRule 删除访问或审核规则。
调用方说明
构造 FileSecurity(String, AccessControlSections) 函数要求当前帐户具有管理权限。 若要使用不具有管理权限的 FileSecurity 帐户为特定文件创建新类实例，请使用 GetAccessControl() 该方法。
