FileStream.SetAccessControl(FileSecurity) Methode

Definition

Wendet Zugriffssteuerungslisteneinträge (Access Control List, ACL) an, die durch ein FileSecurity-Objekt beschriebene Datei auf die datei angewendet werden, 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 ACL-Eintrag beschreibt, der auf die aktuelle Datei angewendet werden soll.

Ausnahmen

Die Datei wird geschlossen.

Der parameter fileSecurity ist null.

Die Datei konnte nicht gefunden oder geändert werden.

Der aktuelle Prozess hat keinen Zugriff auf das Öffnen der Datei.

Hinweise

Während die FileStream Klasse und SetAccessControl in einer vorhandenen Datei verwendet werden können, sollten Sie die verwendung der FileInfo.SetAccessControl-Methode in Betracht ziehen, da sie einfacher zu verwenden ist.

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

Vorsicht

Die für den parameter fileSecurity angegebene ACL ersetzt die vorhandene ACL für die Datei. Verwenden Sie zum Hinzufügen von Berechtigungen für einen neuen Benutzer die GetAccessControl Methode, um die vorhandene ACL abzurufen, sie zu ändern, und verwenden Sie dann SetAccessControl, um sie wieder auf die Datei anzuwenden.

Eine ACL beschreibt Einzelpersonen und Gruppen, die über bestimmte Aktionen für die angegebene Datei verfügen oder keine Rechte haben. Weitere Informationen finden Sie unter How to: Add or Remove Access Control List Entries.

Gilt für: