FileSecurity Конструкторы

Определение

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

System.Security.AccessControl

Сборка:

System.IO.FileSystem.AccessControl.dll

Инициализирует новый экземпляр класса FileSecurity.

Перегрузки

FileSecurity()	Инициализирует новый экземпляр класса FileSecurity.
FileSecurity(String, AccessControlSections)	Инициализирует новый экземпляр класса FileSecurity на основании указанного файла, используя указанные значения из перечисления AccessControlSections.

FileSecurity()

Инициализирует новый экземпляр класса FileSecurity.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Исключения

PlatformNotSupportedException

Текущая операционная система не является системой Microsoft Windows 2000 или более поздней версией Windows.

Комментарии

Используйте этот конструктор, если требуется создать пустой FileSecurity объект, не основанный на существующем файле. Затем можно заполнить объект сведениями об управлении доступом и применить их к файлу.

Вы можете добавить правила доступа или аудита к объекту FileSecurity с помощью AddAccessRule метода . Вы можете удалить правила доступа или аудита с помощью RemoveAccessRule метода .

Чтобы сохранить новые или измененные правила доступа или аудита в файле, используйте SetAccessControl метод или SetAccessControl . Чтобы получить правила доступа или аудита из существующего файла, используйте GetAccessControl метод или GetAccessControl .

FileSecurity(String, AccessControlSections)

Инициализирует новый экземпляр класса FileSecurity на основании указанного файла, используя указанные значения из перечисления AccessControlSections.

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

new System.Security.AccessControl.FileSecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Sub New (fileName As String, includeSections As AccessControlSections)

Параметры

fileName

String

Расположение файла, на основании которого создается объект FileSecurity.

includeSections

AccessControlSections

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

Исключения

ArgumentException

Параметр fileName представляет собой строку нулевой длины, содержащую только пробелы или один или несколько недопустимых символов, заданных методом InvalidPathChars.

DirectoryNotFoundException

Указан недопустимый путь (например, он ведет на несопоставленный диск).

FileNotFoundException

Файл, указанный в параметре fileName, не найден.

IOException

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

NotSupportedException

Параметр path задан в недопустимом формате.

SEHException

Параметр fileName имеет значение null.

PlatformNotSupportedException

Текущая операционная система не является системой Microsoft Windows 2000 или более поздней версией Windows.

PathTooLongException

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.

PrivilegeNotHeldException

Текущая учетная запись системы не имеет прав администратора.

SystemException

Не удалось найти файл.

UnauthorizedAccessException

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

-или-

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

-или-

Параметр fileName указывает каталог.

-или-

У вызывающего объекта отсутствует необходимое разрешение.

Комментарии

Этот конструктор извлекает сведения об управлении доступом для указанного файла, а затем создает FileSecurity объект, инкапсулирующий эти сведения. Затем можно проверить, добавить или удалить сведения об управлении доступом для указанного файла.

Вы можете добавить правила доступа или аудита к объекту FileSecurity с помощью AddAccessRule метода . Вы можете удалить правила доступа или аудита с помощью RemoveAccessRule метода .

Чтобы сохранить новые или измененные правила доступа или аудита в файле, используйте SetAccessControl метод или SetAccessControl . Чтобы получить правила доступа или аудита из существующего файла, используйте GetAccessControl метод или GetAccessControl .

Примечания для тех, кто вызывает этот метод

Конструктор FileSecurity(String, AccessControlSections) требует, чтобы текущая учетная запись была иметь права администратора. Чтобы создать новый экземпляр класса для определенного FileSecurity файла с помощью учетной записи, не обладающей правами администратора, используйте GetAccessControl() метод .