Directory.GetAccessControl Метод

Определение

Пространство имен:

System.IO

Сборка:

mscorlib.dll

Возвращает список управления доступом Windows (ACL) для каталога.

Перегрузки

GetAccessControl(String)	Возвращает объект DirectorySecurity, инкапсулирующий записи списка управления доступом (ACL) для указанного каталога.
GetAccessControl(String, AccessControlSections)	Возвращает объект DirectorySecurity, который инкапсулирует указанный тип записей списка управления доступом (ACL) для указанного каталога.

GetAccessControl(String)

Возвращает объект DirectorySecurity, инкапсулирующий записи списка управления доступом (ACL) для указанного каталога.

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

Параметры

path

String

Путь к каталогу, содержашем объект DirectorySecurity, описывающий сведения о списке управления доступом файла (ACL).

Возвращаемое значение

DirectorySecurity

Объект, инкапсулирующий правила управления доступом для файла, описанного параметром path.

Исключения

ArgumentNullException

Параметр pathnull.

IOException

При открытии каталога произошла ошибка ввода-вывода.

SystemException

Произошла ошибка на уровне системы, например каталог не найден. Конкретное исключение может быть подклассом SystemException.

UnauthorizedAccessException

Параметр path указал каталог, доступный только для чтения.

-или-

Эта операция не поддерживается на текущей платформе.

-или-

Вызывающий объект не имеет требуемого разрешения.

Комментарии

Используйте метод GetAccessControl для получения записей списка управления доступом (ACL) для каталога.

ACL описывает отдельных лиц и групп, имеющих или не имеющих прав на определенные действия в указанном файле или каталоге. Дополнительные сведения см. в разделе Практическое руководство. Добавление или удаление записей списка управления доступом.

В средах NTFS ReadAttributes и ReadExtendedAttributes предоставляются пользователю, если у пользователя есть ListDirectory права на родительскую папку. Чтобы запретить ReadAttributes и ReadExtendedAttributes, запретить ListDirectory в родительском каталоге.

GetAccessControl(String, AccessControlSections)

Возвращает объект DirectorySecurity, который инкапсулирует указанный тип записей списка управления доступом (ACL) для указанного каталога.

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

Параметры

path

String

Путь к каталогу, содержашем объект DirectorySecurity, описывающий сведения о списке управления доступом файла (ACL).

includeSections

AccessControlSections

Одно из значений AccessControlSections, указывающее тип данных списка управления доступом (ACL).

Возвращаемое значение

DirectorySecurity

Объект, инкапсулирующий правила управления доступом для файла, описанного параметром path.

Исключения

ArgumentNullException

Параметр pathnull.

IOException

При открытии каталога произошла ошибка ввода-вывода.

SystemException

Произошла ошибка на уровне системы, например каталог не найден. Конкретное исключение может быть подклассом SystemException.

UnauthorizedAccessException

Параметр path указал каталог, доступный только для чтения.

-или-

Эта операция не поддерживается на текущей платформе.

-или-

Вызывающий объект не имеет требуемого разрешения.

Комментарии

Используйте метод GetAccessControl для получения записей списка управления доступом (ACL) для каталога.

ACL описывает отдельных лиц и групп, имеющих или не имеющих прав на определенные действия в указанном файле или каталоге. Дополнительные сведения см. в разделе Практическое руководство. Добавление или удаление записей списка управления доступом.

В средах NTFS ReadAttributes и ReadExtendedAttributes предоставляются пользователю, если у пользователя есть ListDirectory права на родительскую папку. Чтобы запретить ReadAttributes и ReadExtendedAttributes, запретить ListDirectory в родительском каталоге.