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 или более поздней версии.

Комментарии

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

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

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, указывающее тип сведений о списке управления доступом (ACL).

Исключения

ArgumentException

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

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

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

NotSupportedException

path имеет недопустимый формат.

SEHException

Параметр fileNamenull.

PlatformNotSupportedException

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

PathTooLongException

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

PrivilegeNotHeldException

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

SystemException

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

UnauthorizedAccessException

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

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

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