FileStream.SetAccessControl(FileSecurity) Método

Definição

Aplica-se a entradas da ACL (lista de controle de acesso) descritas por um objeto FileSecurity para o arquivo descrito pelo objeto FileStream atual.Applies access control list (ACL) entries described by a FileSecurity object to the file described by the current FileStream object.

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 para aplicar ao arquivo atual.An object that describes an ACL entry to apply to the current file.

Exceções

O arquivo está fechado.The file is closed.

O parâmetro fileSecurity é null.The fileSecurity parameter is null.

O arquivo não pôde ser encontrado ou modificado.The file could not be found or modified.

O processo atual não tem acesso para abrir o arquivo.The current process does not have access to open the file.

Comentários

Embora a FileStream classe e SetAccessControl possa ser usada em um arquivo existente, considere o uso do File.SetAccessControl método, pois ele é mais fácil de usar.While the FileStream class and SetAccessControl can be used on an existing file, consider using the File.SetAccessControl method as it is easier to use.

O SetAccessControl método aplica entradas de ACL (lista de controle de acesso) a um arquivo que representa a lista ACL não herdada.The SetAccessControl method applies access control list (ACL) entries to a file that represents the noninherited ACL list.

Cuidado

A ACL especificada para o fileSecurity parâmetro substitui a ACL existente para o arquivo.The ACL specified for the fileSecurity parameter replaces the existing ACL for the file. Para adicionar permissões para um novo usuário, use o GetAccessControl método para obter a ACL existente, modifique-a e use SetAccessControl para aplicá-la de volta ao arquivo.To add permissions for a new user, use the GetAccessControl method to obtain the existing ACL, modify it, and then use SetAccessControl to apply it back to the file.

Uma ACL descreve indivíduos e/ou grupos que têm ou não têm direitos sobre ações específicas no arquivo fornecido.An ACL describes individuals and/or groups who have, or do not have, rights to specific actions on the given file. Para saber mais, confira Como adicionar ou remover entradas da lista de controle de acesso.For more information, see How to: Add or Remove Access Control List Entries.

Aplica-se a