Directory.GetAccessControl Método

Definição

Namespace:

System.IO

Assembly:

mscorlib.dll

Retorna a ACL (lista de controle de acesso) do Windows para um diretório.

Sobrecargas

GetAccessControl(String)	Obtém um objeto DirectorySecurity que encapsula as entradas de ACL (lista de controle de acesso) para um diretório especificado.
GetAccessControl(String, AccessControlSections)	Obtém um objeto DirectorySecurity que encapsula o tipo especificado de entradas acl (lista de controle de acesso) para um diretório especificado.

GetAccessControl(String)

Obtém um objeto DirectorySecurity que encapsula as entradas de ACL (lista de controle de acesso) para um diretório especificado.

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

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

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

Public Shared Function GetAccessControl (path As String) As DirectorySecurity

Parâmetros

path

String

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

Retornos

DirectorySecurity

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

Exceções

ArgumentNullException

O parâmetro path é null.

IOException

Ocorreu um erro de E/S ao abrir o diretório.

SystemException

Não foi possível encontrar um erro no nível do sistema, como o diretório. A exceção específica pode ser uma subclasse de SystemException.

UnauthorizedAccessException

O parâmetro path especificou um diretório somente leitura.

-ou-

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

-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 diretório.

Uma ACL descreve indivíduos e grupos que têm, ou não têm, direitos a ações específicas no arquivo ou diretório 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, AccessControlSections)

Obtém um objeto DirectorySecurity que encapsula o tipo especificado de entradas acl (lista de controle de acesso) para um diretório especificado.

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

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

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

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

Parâmetros

path

String

O caminho para um diretório que contém um objeto DirectorySecurity 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

DirectorySecurity

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

Exceções

ArgumentNullException

O parâmetro path é null.

IOException

Ocorreu um erro de E/S ao abrir o diretório.

SystemException

Não foi possível encontrar um erro no nível do sistema, como o diretório. A exceção específica pode ser uma subclasse de SystemException.

UnauthorizedAccessException

O parâmetro path especificou um diretório somente leitura.

-ou-

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

-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 diretório.

Uma ACL descreve indivíduos e grupos que têm, ou não têm, direitos a ações específicas no arquivo ou diretório 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.