Directory.GetAccessControl Méthode

Définition

Espace de noms:

System.IO

Assembly:

mscorlib.dll

Retourne la liste de contrôle d’accès Windows (ACL) pour un répertoire.

Surcharges

GetAccessControl(String)	Obtient un objet DirectorySecurity qui encapsule les entrées de liste de contrôle d’accès (ACL) pour un répertoire spécifié.
GetAccessControl(String, AccessControlSections)	Obtient un objet DirectorySecurity qui encapsule le type spécifié d’entrées de liste de contrôle d’accès (ACL) pour un répertoire spécifié.

GetAccessControl(String)

Obtient un objet DirectorySecurity qui encapsule les entrées de liste de contrôle d’accès (ACL) pour un répertoire spécifié.

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

Paramètres

path

String

Chemin d’accès à un répertoire contenant un objet DirectorySecurity qui décrit les informations de liste de contrôle d’accès (ACL) du fichier.

Retours

DirectorySecurity

Objet qui encapsule les règles de contrôle d’accès pour le fichier décrit par le paramètre path.

Exceptions

ArgumentNullException

Le paramètre path est null.

IOException

Une erreur d’E/S s’est produite lors de l’ouverture du répertoire.

SystemException

Une erreur au niveau du système s’est produite, telle que le répertoire introuvable. L’exception spécifique peut être une sous-classe de SystemException.

UnauthorizedAccessException

Le paramètre path a spécifié un répertoire en lecture seule.

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

-ou-

L’appelant n’a pas l’autorisation requise.

Remarques

Utilisez la méthode GetAccessControl pour récupérer les entrées de liste de contrôle d’accès (ACL) d’un répertoire.

Une liste de contrôle d’accès décrit les individus et les groupes qui ont, ou n’ont pas, des droits pour des actions spécifiques sur le fichier ou le répertoire donné. Pour plus d’informations, consultez Guide pratique pour ajouter ou supprimer des entrées de liste de contrôle d’accès.

Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur a ListDirectory droits sur le dossier parent. Pour refuser ReadAttributes et ReadExtendedAttributes, refusez ListDirectory sur le répertoire parent.

GetAccessControl(String, AccessControlSections)

Obtient un objet DirectorySecurity qui encapsule le type spécifié d’entrées de liste de contrôle d’accès (ACL) pour un répertoire spécifié.

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

Paramètres

path

String

Chemin d’accès à un répertoire contenant un objet DirectorySecurity qui décrit les informations de liste de contrôle d’accès (ACL) du fichier.

includeSections

AccessControlSections

Une des valeurs AccessControlSections qui spécifie le type d’informations de liste de contrôle d’accès à recevoir.

Retours

DirectorySecurity

Objet qui encapsule les règles de contrôle d’accès pour le fichier décrit par le paramètre path.

Exceptions

ArgumentNullException

Le paramètre path est null.

IOException

Une erreur d’E/S s’est produite lors de l’ouverture du répertoire.

SystemException

Une erreur au niveau du système s’est produite, telle que le répertoire introuvable. L’exception spécifique peut être une sous-classe de SystemException.

UnauthorizedAccessException

Le paramètre path a spécifié un répertoire en lecture seule.

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

-ou-

L’appelant n’a pas l’autorisation requise.

Remarques

Utilisez la méthode GetAccessControl pour récupérer les entrées de liste de contrôle d’accès (ACL) d’un répertoire.

Une liste de contrôle d’accès décrit les individus et les groupes qui ont, ou n’ont pas, des droits pour des actions spécifiques sur le fichier ou le répertoire donné. Pour plus d’informations, consultez Guide pratique pour ajouter ou supprimer des entrées de liste de contrôle d’accès.

Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur a ListDirectory droits sur le dossier parent. Pour refuser ReadAttributes et ReadExtendedAttributes, refusez ListDirectory sur le répertoire parent.