FileStream.SetAccessControl(FileSecurity) Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

mscorlib.dll

Stosuje wpisy listy kontroli dostępu (ACL) opisane przez obiekt FileSecurity do pliku opisanego przez bieżący obiekt 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

Obiekt opisujący wpis listy ACL, który ma być stosowany do bieżącego pliku.

Wyjątki

ObjectDisposedException

Plik jest zamknięty.

ArgumentNullException

Parametr fileSecurity jest null.

SystemException

Nie można odnaleźć ani zmodyfikować pliku.

UnauthorizedAccessException

Bieżący proces nie ma dostępu do otwierania pliku.

Uwagi

Chociaż klasa FileStream i SetAccessControl mogą być używane w istniejącym pliku, rozważ użycie metody FileInfo.SetAccessControl, ponieważ jest to łatwiejsze do użycia.

Metoda SetAccessControl stosuje wpisy listy kontroli dostępu (ACL) do pliku reprezentującego nienastawioną listę listy ACL.

Ostrożność

Lista ACL określona dla parametru fileSecurity zastępuje istniejącą listę ACL pliku. Aby dodać uprawnienia dla nowego użytkownika, użyj metody GetAccessControl, aby uzyskać istniejącą listę ACL, zmodyfikować ją, a następnie użyć SetAccessControl, aby zastosować go z powrotem do pliku.

Lista ACL opisuje osoby i grupy, które mają lub nie mają praw do określonych akcji w danym pliku. Aby uzyskać więcej informacji, zobacz Instrukcje: dodawanie lub usuwanie wpisów listy kontroli dostępu.