File.GetAccessControl Méthode

Définition

Espace de noms:

System.IO

Assembly:

mscorlib.dll

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

Surcharges

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

GetAccessControl(String)

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

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

Paramètres

path

String

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

Retours

FileSecurity

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

Exceptions

IOException

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

SEHException

Le paramètre path est null.

SystemException

Impossible de trouver le fichier.

UnauthorizedAccessException

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

-ou-

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

-ou-

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

-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 fichier.

Une liste de contrôle d’accès décrit les personnes et les groupes qui ont, ou n’ont pas, des droits pour des actions spécifiques sur le fichier 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 FileSecurity qui encapsule le type spécifié d’entrées de liste de contrôle d’accès (ACL) pour un fichier particulier.

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

Paramètres

path

String

Chemin d’accès à un fichier contenant un objet FileSecurity 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

FileSecurity

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

Exceptions

IOException

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

SEHException

Le paramètre path est null.

SystemException

Impossible de trouver le fichier.

UnauthorizedAccessException

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

-ou-

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

-ou-

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

-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 fichier.

Une liste de contrôle d’accès décrit les personnes et les groupes qui ont, ou n’ont pas, des droits pour des actions spécifiques sur le fichier 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.