Export (0) Print
Expand All

FileSystemSecurity.RemoveAccessRuleSpecific Method (FileSystemAccessRule)

Note: This method is new in the .NET Framework version 2.0.

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

Namespace: System.Security.AccessControl
Assembly: mscorlib (in mscorlib.dll)

public void RemoveAccessRuleSpecific (
	FileSystemAccessRule rule
)
public void RemoveAccessRuleSpecific (
	FileSystemAccessRule rule
)
public function RemoveAccessRuleSpecific (
	rule : FileSystemAccessRule
)

Parameters

rule

A FileSystemAccessRule object that specifies a user whose access control list (ACL) permissions should be removed from a file or directory.

Exception typeCondition

ArgumentNullException

The rule parameter is a null reference (Nothing in Visual Basic).

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.

To persist new or changed access control list (ACL) information to a file, use the SetAccessControl or SetAccessControl method. To persist new or changed ACL information to a directory, use the SetAccessControl or SetAccessControl method.

To retrieve ACL information from a file, use the GetAccessControl or GetAccessControl method. To retrieve ACL information from a directory, use the GetAccessControl or GetAccessControl method.

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.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft