FileSecurity Constructores

Definición

Espacio de nombres:

System.Security.AccessControl

Ensamblado:

System.IO.FileSystem.AccessControl.dll

Inicializa una nueva instancia de la clase FileSecurity.

Sobrecargas

FileSecurity()	Inicializa una nueva instancia de la clase FileSecurity.
FileSecurity(String, AccessControlSections)	Inicializa una nueva instancia de la clase FileSecurity a partir de un archivo especificado utilizando los valores especificados de la enumeración AccessControlSections.

FileSecurity()

Inicializa una nueva instancia de la clase FileSecurity.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Excepciones

PlatformNotSupportedException

El sistema operativo actual no es Microsoft Windows 2000 o posterior.

Comentarios

Use este constructor cuando desee crear un objeto vacío FileSecurity que no se base en un archivo existente. A continuación, puede rellenar el objeto con información de control de acceso y aplicarlo a un archivo.

Puede agregar reglas de acceso o auditoría al FileSecurity objeto mediante el AddAccessRule método . Puede quitar las reglas de acceso o auditoría mediante el RemoveAccessRule método .

Para conservar reglas de acceso o auditoría nuevas o modificadas en un archivo, use el SetAccessControl método o SetAccessControl . Para recuperar las reglas de acceso o auditoría de un archivo existente, use el GetAccessControl método o GetAccessControl .

FileSecurity(String, AccessControlSections)

Inicializa una nueva instancia de la clase FileSecurity a partir de un archivo especificado utilizando los valores especificados de la enumeración 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)

Parámetros

fileName

String

Ubicación del archivo a partir del que se va a crear un objeto FileSecurity.

includeSections

AccessControlSections

Uno de los valores de AccessControlSections que especifica el tipo de información de la lista de control de acceso (ACL) que se va a recuperar.

Excepciones

ArgumentException

El parámetro fileName es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

FileNotFoundException

No se encuentra el archivo especificado en el parámetro fileName.

IOException

Se produjo un error de E/S al abrir el archivo.

NotSupportedException

path está en un formato no válido.

SEHException

El parámetro fileName es null.

PlatformNotSupportedException

El sistema operativo actual no es Microsoft Windows 2000 o posterior.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

PrivilegeNotHeldException

La cuenta del sistema actual no tiene privilegios administrativos.

SystemException

No se encuentra el archivo.

UnauthorizedAccessException

El parámetro fileName especificó un archivo que es de solo lectura.

o bien

Esta operación no es compatible con la plataforma actual.

o bien

El parámetro fileName especificó un directorio.

o bien

El llamador no dispone del permiso requerido.

Comentarios

Este constructor recupera la información de control de acceso para el archivo especificado y, a continuación, crea un FileSecurity objeto que encapsula esa información. A continuación, puede inspeccionar, agregar o eliminar la información de control de acceso del archivo especificado.

Puede agregar reglas de acceso o auditoría al FileSecurity objeto mediante el AddAccessRule método . Puede quitar las reglas de acceso o auditoría mediante el RemoveAccessRule método .

Para conservar reglas de acceso o auditoría nuevas o modificadas en un archivo, use el SetAccessControl método o SetAccessControl . Para recuperar las reglas de acceso o auditoría de un archivo existente, use el GetAccessControl método o GetAccessControl .

Notas a los autores de las llamadas

El FileSecurity(String, AccessControlSections) constructor requiere que la cuenta actual tenga privilegios administrativos. Para crear una nueva instancia de la FileSecurity clase para un archivo específico mediante una cuenta que no tenga privilegios administrativos, use el GetAccessControl() método .