FileStream.SetAccessControl(FileSecurity) Método

Definição

Namespace:

System.IO

Assembly:

mscorlib.dll

Aplica entradas acl (lista de controle de acesso) descritas por um objeto FileSecurity ao arquivo descrito pelo objeto FileStream atual.

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

Um objeto que descreve uma entrada ACL a ser aplicada ao arquivo atual.

Exceções

ObjectDisposedException

O arquivo está fechado.

ArgumentNullException

O parâmetro fileSecurity é null.

SystemException

Não foi possível encontrar ou modificar o arquivo.

UnauthorizedAccessException

O processo atual não tem acesso para abrir o arquivo.

Comentários

Embora a classe FileStream e SetAccessControl possam ser usadas em um arquivo existente, considere usar o método FileInfo.SetAccessControl, pois é mais fácil de usar.

O método SetAccessControl aplica entradas acl (lista de controle de acesso) a um arquivo que representa a lista de ACL não herdada.

Cuidado

A ACL especificada para o parâmetro fileSecurity substitui a ACL existente para o arquivo. Para adicionar permissões para um novo usuário, use o método GetAccessControl para obter a ACL existente, modificá-la e, em seguida, usar SetAccessControl para aplicá-la de volta ao arquivo.

Uma ACL descreve indivíduos e grupos que têm ou não direitos a ações específicas no arquivo especificado. Para obter mais informações, consulte Como adicionar ou remover entradas de lista de controle de acesso.