Directory.GetAccessControl Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

mscorlib.dll

Zwraca listę kontroli dostępu systemu Windows (ACL) dla katalogu.

Przeciążenia

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

GetAccessControl(String)

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

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

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

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

Public Shared Function GetAccessControl (path As String) As DirectorySecurity

Parametry

path

String

Ścieżka do katalogu zawierającego obiekt DirectorySecurity opisujący informacje listy kontroli dostępu (ACL) pliku.

Zwraca

DirectorySecurity

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

Wyjątki

ArgumentNullException

Parametr path jest null.

IOException

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

SystemException

Wystąpił błąd na poziomie systemu, taki jak nie można odnaleźć katalogu. Konkretnym wyjątkiem może być podklasa SystemException.

UnauthorizedAccessException

Parametr path określił katalog, który jest tylko do odczytu.

-lub-

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

-lub-

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

Uwagi

Użyj metody GetAccessControl, aby pobrać wpisy listy kontroli dostępu (ACL) dla katalogu.

Lista ACL opisuje osoby i grupy, które mają lub nie mają praw do określonych akcji dla danego pliku lub katalogu. 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 DirectorySecurity, który hermetyzuje określony typ wpisów listy kontroli dostępu (ACL) dla określonego katalogu.

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

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

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

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

Parametry

path

String

Ścieżka do katalogu zawierającego obiekt DirectorySecurity opisujący informacje listy 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

DirectorySecurity

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

Wyjątki

ArgumentNullException

Parametr path jest null.

IOException

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

SystemException

Wystąpił błąd na poziomie systemu, taki jak nie można odnaleźć katalogu. Konkretnym wyjątkiem może być podklasa SystemException.

UnauthorizedAccessException

Parametr path określił katalog, który jest tylko do odczytu.

-lub-

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

-lub-

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

Uwagi

Użyj metody GetAccessControl, aby pobrać wpisy listy kontroli dostępu (ACL) dla katalogu.

Lista ACL opisuje osoby i grupy, które mają lub nie mają praw do określonych akcji dla danego pliku lub katalogu. 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.