FileStream.SetAccessControl(FileSecurity) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

mscorlib.dll

Použije položky seznamu řízení přístupu (ACL) popsané objektem FileSecurity na soubor popsaný aktuálním objektem FileStream.

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)

Parametry

fileSecurity

FileSecurity

Objekt, který popisuje položku seznamu ACL, která se má použít pro aktuální soubor.

Výjimky

ObjectDisposedException

Soubor je zavřený.

ArgumentNullException

Parametr fileSecurity je null.

SystemException

Soubor nebyl nalezen nebo změněn.

UnauthorizedAccessException

Aktuální proces nemá přístup k otevření souboru.

Poznámky

I když FileStream třídy a SetAccessControl lze použít u existujícího souboru, zvažte použití metody FileInfo.SetAccessControl, protože je jednodušší.

Metoda SetAccessControl použije položky seznamu řízení přístupu (ACL) na soubor, který představuje nezahrnutou seznam ACL.

Opatrnost

Seznam ACL zadaný pro parametr fileSecurity nahradí existující seznam ACL souboru. Pokud chcete přidat oprávnění pro nového uživatele, použijte metodu GetAccessControl k získání existujícího seznamu ACL, úpravě a následnému použití SetAccessControl ho použít zpět na soubor.

Seznam ACL popisuje jednotlivce a skupiny, které mají nebo nemají práva ke konkrétním akcím daného souboru. Další informace naleznete v tématu Postupy: Přidání nebo odebrání položek seznamu řízení přístupu.