FileStream.SetAccessControl(FileSecurity) Methode

Definition

Namespace:

System.IO

Assembly:

mscorlib.dll

Wendet von einem FileSecurity-Objekt beschriebene Einträge in Zugriffssteuerungslisten auf die Datei an, die vom aktuellen FileStream-Objekt beschrieben wird.

public:
 void SetAccessControl(System::Security::AccessControl::FileSecurity ^ fileSecurity);

public void SetAccessControl (System.Security.AccessControl.FileSecurity fileSecurity);

member this.SetAccessControl : System.Security.AccessControl.FileSecurity -> unit

Public Sub SetAccessControl (fileSecurity As FileSecurity)

Parameter

fileSecurity

FileSecurity

Ein Objekt, das einen Eintrag in einer Zugriffssteuerungsliste beschreibt, der auf die aktuelle Datei angewendet werden soll.

Ausnahmen

ObjectDisposedException

Die Datei ist geschlossen.

ArgumentNullException

Der fileSecurity-Parameter ist null.

SystemException

Die Datei konnte nicht gefunden oder geändert werden.

UnauthorizedAccessException

Der aktuelle Prozess hat keinen Zugriff zum Öffnen der Datei.

Hinweise

Während die FileStream -Klasse und SetAccessControl für eine vorhandene Datei verwendet werden können, sollten Sie die File.SetAccessControl -Methode verwenden, da sie einfacher zu verwenden ist.

Die SetAccessControl -Methode wendet Einträge der Zugriffssteuerungsliste (Access Control List, ACL) auf eine Datei an, die die nicht enthaltene ACL-Liste darstellt.

Achtung

Die für den fileSecurity Parameter angegebene ACL ersetzt die vorhandene ACL für die Datei. Um Berechtigungen für einen neuen Benutzer hinzuzufügen, verwenden Sie die GetAccessControl -Methode, um die vorhandene ACL abzurufen, zu ändern und dann zu verwenden SetAccessControl , um sie wieder auf die Datei anzuwenden.

Eine ACL beschreibt Personen und/oder Gruppen, die Rechte auf bestimmte Aktionen für die angegebene Datei haben oder nicht haben. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen oder Entfernen von Zugriffssteuerungslisten-Einträgen.