FileSystemSecurity.RemoveAccessRuleSpecific(FileSystemAccessRule) Methode

Definition

Namespace:

System.Security.AccessControl

Assembly:

System.IO.FileSystem.AccessControl.dll

Entfernt eine einzelne Übereinstimmungsberechtigung für die Zugriffssteuerungsliste (Access Control List, ACL) aus der aktuellen Datei oder dem aktuellen Verzeichnis.

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)

Parameter

rule

FileSystemAccessRule

Ein FileSystemAccessRule-Objekt, das einen Benutzer angibt, dessen Zugriffssteuerungsliste (Access Control List, ACL)-Berechtigungen aus einer Datei oder einem Verzeichnis entfernt werden sollen.

Ausnahmen

ArgumentNullException

Der parameter rule ist null.

Hinweise

Die RemoveAccessRuleSpecific-Methode entfernt die angegebene Deny Zugriffsregel oder die angegebene übereinstimmende Allow Zugriffsregel aus dem aktuellen FileSystemSecurity-Objekt. Sie können diese Methode beispielsweise verwenden, um eine angegebene Deny Zugriffsregel für einen Benutzer zu entfernen, indem Sie ein FileSystemAccessRule Objekt übergeben, das mithilfe des Deny Werts, des Read Werts und eines Benutzerkontos erstellt wurde. In diesem Fall entfernt die RemoveAccessRuleSpecific-Methode nur die Verweigerungsregel, die den Read Wert angibt. Es werden keine Ablehnungsregeln entfernt, die den Write Wert angeben.

Verwenden Sie die folgenden von der .NET-Implementierung abhängigen Methoden, um ACL-Informationen aus einer Datei hinzuzufügen oder abzurufen:

.NET-Implementierung	Hinzufügen von Regeln	Regeln abrufen
.NETTO	FileSystemAclExtensions.SetAccessControl(FileInfo, FileSecurity)	FileSystemAclExtensions.GetAccessControl(FileInfo)
.NET Framework	FileInfo.SetAccessControl(FileSecurity)	FileInfo.GetAccessControl()

Wenn Sie eine Zugriffsregel hinzufügen, ohne die Synchronize-Kennzeichnung festzulegen, wird die Synchronize-Kennzeichnung automatisch zu Ihrer Regel hinzugefügt. Wenn Sie die Regel später entfernen, ohne die Synchronize Kennzeichnung anzugeben, wird die Kennzeichnung automatisch entfernt.