File.GetAccessControl Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

mscorlib.dll

Pobiera obiekt FileSecurity, który hermetyzuje wpisy listy kontroli dostępu (ACL) dla określonego pliku.

Przeciążenia

GetAccessControl(String)	Pobiera obiekt FileSecurity, który hermetyzuje wpisy listy kontroli dostępu (ACL) dla określonego pliku.
GetAccessControl(String, AccessControlSections)	Pobiera obiekt FileSecurity, który hermetyzuje określony typ wpisów listy kontroli dostępu (ACL) dla określonego pliku.

GetAccessControl(String)

Pobiera obiekt FileSecurity, który hermetyzuje wpisy listy kontroli dostępu (ACL) dla określonego pliku.

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path);

static member GetAccessControl : string -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String) As FileSecurity

Parametry

path

String

Ścieżka do pliku zawierającego obiekt FileSecurity opisujący informacje o liście kontroli dostępu (ACL) pliku.

Zwraca

FileSecurity

Obiekt FileSecurity, który hermetyzuje reguły kontroli dostępu dla pliku opisanego przez parametr path.

Wyjątki

IOException

Wystąpił błąd we/wy podczas otwierania pliku.

SEHException

Parametr path jest null.

SystemException

Nie można odnaleźć pliku.

UnauthorizedAccessException

Parametr path określił plik tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

Parametr path określił katalog.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

Uwagi

Użyj metody GetAccessControl, aby pobrać wpisy listy kontroli dostępu (ACL) dla 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.

W środowiskach NTFS ReadAttributes i ReadExtendedAttributes są przyznawane użytkownikowi, jeśli użytkownik ma ListDirectory prawa do folderu nadrzędnego. Aby odmówić ReadAttributes i ReadExtendedAttributes, odmów ListDirectory w katalogu nadrzędnym.

GetAccessControl(String, AccessControlSections)

Pobiera obiekt FileSecurity, który hermetyzuje określony typ wpisów listy kontroli dostępu (ACL) dla określonego pliku.

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

Parametry

path

String

Ścieżka do pliku zawierającego obiekt FileSecurity opisujący informacje o liście kontroli dostępu (ACL) pliku.

includeSections

AccessControlSections

Jedna z AccessControlSections wartości, która określa typ informacji listy kontroli dostępu (ACL) do odbierania.

Zwraca

FileSecurity

Obiekt FileSecurity, który hermetyzuje reguły kontroli dostępu dla pliku opisanego przez parametr path.

Wyjątki

IOException

Wystąpił błąd we/wy podczas otwierania pliku.

SEHException

Parametr path jest null.

SystemException

Nie można odnaleźć pliku.

UnauthorizedAccessException

Parametr path określił plik tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

Parametr path określił katalog.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

Uwagi

Użyj metody GetAccessControl, aby pobrać wpisy listy kontroli dostępu (ACL) dla 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.

W środowiskach NTFS ReadAttributes i ReadExtendedAttributes są przyznawane użytkownikowi, jeśli użytkownik ma ListDirectory prawa do folderu nadrzędnego. Aby odmówić ReadAttributes i ReadExtendedAttributes, odmów ListDirectory w katalogu nadrzędnym.