FileStream.SetAccessControl(FileSecurity) Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ObjectDisposedException

Die Datei wird geschlossen.

ArgumentNullException

Der parameter fileSecurity ist null.

SystemException

Die Datei konnte nicht gefunden oder geändert werden.

UnauthorizedAccessException

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:

Freigeben über