FileStream.SetAccessControl(FileSecurity) Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

mscorlib.dll

Aplica entradas de lista de control de acceso (ACL) descritas por un objeto FileSecurity al archivo descrito por el objeto FileStream actual.

public:
 void SetAccessControl(System::Security::AccessControl::FileSecurity ^ fileSecurity);

public void SetAccessControl (System.Security.AccessControl.FileSecurity fileSecurity);

member this.SetAccessControl : System.Security.AccessControl.FileSecurity -> unit

Public Sub SetAccessControl (fileSecurity As FileSecurity)

Parámetros

fileSecurity

FileSecurity

Objeto que describe una entrada de ACL que se va a aplicar al archivo actual.

Excepciones

ObjectDisposedException

El archivo está cerrado.

ArgumentNullException

El parámetro fileSecurity es null.

SystemException

No se encontró ni modificó el archivo.

UnauthorizedAccessException

El proceso actual no tiene acceso para abrir el archivo.

Comentarios

Aunque la clase FileStream y SetAccessControl se pueden usar en un archivo existente, considere la posibilidad de usar el método FileInfo.SetAccessControl, ya que es más fácil de usar.

El método SetAccessControl aplica entradas de lista de control de acceso (ACL) a un archivo que representa la lista de ACL noherida.

Cautela

La ACL especificada para el parámetro fileSecurity reemplaza la ACL existente para el archivo. Para agregar permisos para un nuevo usuario, use el método GetAccessControl para obtener la ACL existente, modificarla y, a continuación, usar SetAccessControl para volver a aplicarla al archivo.

Una ACL describe individuos y grupos que tienen derechos, o no, a acciones específicas en el archivo especificado. Para obtener más información, vea Cómo: Agregar o quitar entradas de lista de control de acceso.