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 FileSecurity vazio que não se baseia 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 objeto FileSecurity usando o método AddAccessRule. Você pode remover regras de acesso ou auditoria usando o método RemoveAccessRule.

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 de ACL (lista de controle de acesso) a serem recuperadas.

Exceções

ArgumentException

O parâmetro fileName é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém 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

Ocorreu um erro de E/S 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 do arquivo ou ambos excedem o comprimento 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 que é 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 objeto FileSecurity que encapsula essas informações. Em seguida, você pode inspecionar, adicionar ou excluir as informações de controle de acesso para o arquivo especificado.

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

Notas aos Chamadores

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