File.GetAccessControl Método

Definição

Namespace:

System.IO

Assembly:

mscorlib.dll

Obtém um objeto FileSecurity que encapsula as entradas de ACL (lista de controle de acesso) para um arquivo especificado.

Sobrecargas

GetAccessControl(String, AccessControlSections)	Obtém um objeto FileSecurity que encapsula o tipo especificado de entradas acl (lista de controle de acesso) para um arquivo específico.
GetAccessControl(String)	Obtém um objeto FileSecurity que encapsula as entradas de ACL (lista de controle de acesso) para um arquivo especificado.

GetAccessControl(String, AccessControlSections)

Obtém um objeto FileSecurity que encapsula o tipo especificado de entradas acl (lista de controle de acesso) para um arquivo específico.

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

Parâmetros

path

String

O caminho para um arquivo que contém um objeto FileSecurity que descreve as informações da ACL (lista de controle de acesso) do arquivo.

includeSections

AccessControlSections

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

Retornos

FileSecurity

Um objeto FileSecurity que encapsula as regras de controle de acesso para o arquivo descrito pelo parâmetro path.

Exceções

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

SEHException

O parâmetro path é null.

SystemException

Não foi possível encontrar o arquivo.

UnauthorizedAccessException

O parâmetro path especificou um arquivo que é somente leitura.

-ou-

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

-ou-

O parâmetro path especificou um diretório.

-ou-

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

Comentários

Use o método GetAccessControl para recuperar as entradas de ACL (lista de controle de acesso) para um 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.

Em ambientes NTFS, ReadAttributes e ReadExtendedAttributes serão concedidos ao usuário se o usuário tiver direitos de ListDirectory na pasta pai. Para negar ReadAttributes e ReadExtendedAttributes, negue ListDirectory no diretório pai.

GetAccessControl(String)

Obtém um objeto FileSecurity que encapsula as entradas de ACL (lista de controle de acesso) para um arquivo especificado.

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path);

static member GetAccessControl : string -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String) As FileSecurity

Parâmetros

path

String

O caminho para um arquivo que contém um objeto FileSecurity que descreve as informações da ACL (lista de controle de acesso) do arquivo.

Retornos

FileSecurity

Um objeto FileSecurity que encapsula as regras de controle de acesso para o arquivo descrito pelo parâmetro path.

Exceções

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

SEHException

O parâmetro path é null.

SystemException

Não foi possível encontrar o arquivo.

UnauthorizedAccessException

O parâmetro path especificou um arquivo que é somente leitura.

-ou-

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

-ou-

O parâmetro path especificou um diretório.

-ou-

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

Comentários

Use o método GetAccessControl para recuperar as entradas de ACL (lista de controle de acesso) para um 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.

Em ambientes NTFS, ReadAttributes e ReadExtendedAttributes serão concedidos ao usuário se o usuário tiver direitos de ListDirectory na pasta pai. Para negar ReadAttributes e ReadExtendedAttributes, negue ListDirectory no diretório pai.