FileSystemSecurity.RemoveAccessRuleAll(FileSystemAccessRule) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Removes all access control list (ACL) permissions for the specified user from the current file or directory.
public:
void RemoveAccessRuleAll(System::Security::AccessControl::FileSystemAccessRule ^ rule);public void RemoveAccessRuleAll (System.Security.AccessControl.FileSystemAccessRule rule);override this.RemoveAccessRuleAll : System.Security.AccessControl.FileSystemAccessRule -> unitPublic Sub RemoveAccessRuleAll (rule As FileSystemAccessRule)Parameters
- rule
- FileSystemAccessRule
A FileSystemAccessRule object that specifies a user whose access control list (ACL) permissions should be removed from a file or directory.
Exceptions
The rule parameter is null.
Remarks
The RemoveAccessRuleAll method removes all access control list (ACL) permissions for the specified user. The method ignores all values in the FileSystemAccessRule object except the user account.
Use the following .NET implementation-dependent methods to add or retrieve ACL information from a file:
| .NET implementation | Add rules | Retrieve rules |
|---|---|---|
| .NET | FileSystemAclExtensions.SetAccessControl(FileInfo, FileSecurity) | FileSystemAclExtensions.GetAccessControl(FileInfo) |
| .NET Framework | FileInfo.SetAccessControl(FileSecurity) | FileInfo.GetAccessControl() |
When you add an access rule without setting the Synchronize flag, the Synchronize flag will be automatically added to your rule. If you remove the rule later without specifying the Synchronize flag, the flag will automatically be removed.
