FileSecurity Construtores

Definição

Namespace:

System.Security.AccessControl

Assembly:

System.IO.FileSystem.AccessControl.dll

Inicializa uma nova instância da classe FileSecurity.

Sobrecargas

FileSecurity()	Inicializa uma nova instância da classe FileSecurity.
FileSecurity(String, AccessControlSections)	Inicializa uma nova instância da classe FileSecurity de um arquivo especificado usando os valores especificados da enumeração AccessControlSections.

FileSecurity()

Inicializa uma nova instância da classe FileSecurity.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Exceções

PlatformNotSupportedException

O sistema operacional atual não é o Microsoft Windows 2000 ou posterior.

Comentários

Use esse construtor quando quiser criar um objeto vazio FileSecurity que não seja baseado em um arquivo existente. Em seguida, você pode preencher o objeto com informações de controle de acesso e aplicá-lo a um arquivo.

Você pode adicionar regras de acesso ou auditoria ao FileSecurity objeto usando o AddAccessRule método . Você pode remover regras de acesso ou auditoria usando o RemoveAccessRule método .

Para persistir regras de acesso ou auditoria novas ou alteradas em um arquivo, use o SetAccessControl método ou SetAccessControl . Para recuperar regras de acesso ou auditoria de um arquivo existente, use o GetAccessControl método ou GetAccessControl .

FileSecurity(String, AccessControlSections)

Inicializa uma nova instância da classe FileSecurity de um arquivo especificado usando os valores especificados da enumeração 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

O local de um arquivo do qual criar um objeto FileSecurity.

includeSections

AccessControlSections

Um dos valores AccessControlSections que especifica o tipo de informações da ACL (lista de controle de acesso) a serem recuperadas.

Exceções

ArgumentException

O parâmetro fileName é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

FileNotFoundException

O arquivo especificado no parâmetro fileName não foi encontrado.

IOException

Um erro de E/S ocorreu ao abrir o arquivo.

NotSupportedException

path está em um formato inválido.

SEHException

O parâmetro fileName é null.

PlatformNotSupportedException

O sistema operacional atual não é o Microsoft Windows 2000 ou posterior.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

PrivilegeNotHeldException

A conta do sistema atual não tem privilégios administrativos.

SystemException

Não foi possível encontrar o arquivo.

UnauthorizedAccessException

O parâmetro fileName especificou um arquivo somente leitura.

- ou -

Não há suporte para essa operação na plataforma atual.

- ou -

O parâmetro fileName especificou um diretório.

- ou -

O chamador não tem a permissão necessária.

Comentários

Esse construtor recupera as informações de controle de acesso do arquivo especificado e cria um FileSecurity objeto que encapsula essas informações. Em seguida, você pode inspecionar, adicionar ou excluir as informações de controle de acesso do arquivo especificado.

Você pode adicionar regras de acesso ou auditoria ao FileSecurity objeto usando o AddAccessRule método . Você pode remover regras de acesso ou auditoria usando o RemoveAccessRule método .

Para persistir regras de acesso ou auditoria novas ou alteradas em um arquivo, use o SetAccessControl método ou SetAccessControl . Para recuperar regras de acesso ou auditoria de um arquivo existente, use o GetAccessControl método ou GetAccessControl .

Notas aos Chamadores

O FileSecurity(String, AccessControlSections) construtor exige que a conta atual tenha privilégios administrativos. Para criar uma nova instância da FileSecurity classe para um arquivo específico usando uma conta que não tem privilégios administrativos, use o GetAccessControl() método .