FileSystemSecurity.RemoveAccessRuleSpecific(FileSystemAccessRule) Method

Definition

Namespace:

System.Security.AccessControl

Assembly:

System.IO.FileSystem.AccessControl.dll

Removes a single matching allow or deny access control list (ACL) permission from the current file or directory.

C#

public void RemoveAccessRuleSpecific(System.Security.AccessControl.FileSystemAccessRule rule);

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

ArgumentNullException

The rule parameter is null.

Remarks

The RemoveAccessRuleSpecific method removes the specified Deny access rule or the specified matching Allow access rule from the current FileSystemSecurity object. For example, you can use this method to remove a specified Deny access rule for a user by passing a FileSystemAccessRule object created using the Deny value, the Read value, and a user account. When you do this, the RemoveAccessRuleSpecific method removes only the deny rule that specifies the Read value. It does not remove any deny rules that specify the Write value.

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.

Applies to