FileSystemSecurity.RemoveAccessRuleSpecific(FileSystemAccessRule) 方法

定義

命名空間:

System.Security.AccessControl

組件:

System.IO.FileSystem.AccessControl.dll

組件:

mscorlib.dll

從目前的檔案或目錄中，移除相符的單一允許或拒絕存取控制清單 (ACL) 使用權限。

public:
 void RemoveAccessRuleSpecific(System::Security::AccessControl::FileSystemAccessRule ^ rule);

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

override this.RemoveAccessRuleSpecific : System.Security.AccessControl.FileSystemAccessRule -> unit

Public Sub RemoveAccessRuleSpecific (rule As FileSystemAccessRule)

參數

rule

FileSystemAccessRule

FileSystemAccessRule 物件，指定應該從檔案或目錄中移除其存取控制清單 (ACL) 使用權限的使用者。

例外狀況

ArgumentNullException

rule 參數為 null。

備註

方法 RemoveAccessRuleSpecific 會從目前的 FileSystemSecurity 物件中移除指定的 Deny 存取規則或指定的相符 Allow 存取規則。 例如，您可以使用這個方法來移除使用者的指定 Deny 存取規則，方法是傳遞 FileSystemAccessRule 使用 Deny 值、 Read 值和使用者帳戶建立的 物件。 當您這樣做時， RemoveAccessRuleSpecific 方法只會移除指定 Read 值的拒絕規則。 它不會移除任何指定 Write 值的拒絕規則。

若要將新的或變更的存取控制清單保存 (ACL) 資訊至檔案，請使用 SetAccessControl 或 SetAccessControl 方法。 若要將新的或變更的 ACL 資訊保存到目錄，請使用 SetAccessControl 或 SetAccessControl 方法。

若要從檔案擷取 ACL 資訊，請使用 GetAccessControl 或 GetAccessControl 方法。 若要從目錄擷取 ACL 資訊，請使用 GetAccessControl 或 GetAccessControl 方法。

當您新增存取規則而不設定 Synchronize 旗標時， Synchronize 會自動將旗標新增至您的規則。 如果您稍後移除規則而不指定 Synchronize 旗標，則會自動移除旗標。