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 。
若要将新的或更改的访问权限或审核规则保存到文件,请使用 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) 信息的类型。
例外
fileName
参数为长度为零的字符串,仅包含空格,或包含一个或多个由 InvalidPathChars 定义的无效字符。
指定的路径无效(例如,它位于未映射的驱动器上)。
未找到 fileName
参数中所指定的文件。
打开文件时发生 I/O 错误。
path
的格式无效。
fileName
参数为 null
。
当前操作系统不是 Microsoft Windows 2000 或更高版本。
指定的路径和/或文件名超过了系统定义的最大长度。
当前的系统帐户没有管理权限。
找不到文件。
fileName
参数指定了一个只读文件。
- 或 -
当前平台不支持此操作。
- 或 -
fileName
参数指定了一个目录。
- 或 -
调用方没有所要求的权限。
注解
此构造函数检索指定文件的访问控制信息,然后创建封装 FileSecurity 该信息的 对象。 然后,可以检查、添加或删除指定文件的访问控制信息。
可以使用 方法向 FileSecurity 对象 AddAccessRule 添加访问或审核规则。 可以使用 方法删除访问或审核规则 RemoveAccessRule 。
若要将新的或更改的访问权限或审核规则保存到文件,请使用 SetAccessControl 或 SetAccessControl 方法。 若要从现有文件中检索访问或审核规则,请使用 GetAccessControl 或 GetAccessControl 方法。
调用方说明
构造 FileSecurity(String, AccessControlSections) 函数要求当前帐户具有管理权限。 若要使用不具有管理权限的 FileSecurity 帐户为特定文件创建 类的新实例,请使用 GetAccessControl() 方法。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈