File.SetAccessControl(String, FileSecurity) Méthode

Définition

Espace de noms:

System.IO

Assembly:

mscorlib.dll

Applique les entrées de liste de contrôle d’accès (ACL) décrites par un objet FileSecurity au fichier spécifié.

public:
 static void SetAccessControl(System::String ^ path, System::Security::AccessControl::FileSecurity ^ fileSecurity);

public static void SetAccessControl (string path, System.Security.AccessControl.FileSecurity fileSecurity);

static member SetAccessControl : string * System.Security.AccessControl.FileSecurity -> unit

Public Shared Sub SetAccessControl (path As String, fileSecurity As FileSecurity)

Paramètres

path

String

Fichier à partir duquel ajouter ou supprimer des entrées de liste de contrôle d’accès (ACL).

fileSecurity

FileSecurity

Objet FileSecurity qui décrit une entrée de liste de contrôle d’accès à appliquer au 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.

ArgumentNullException

Le paramètre fileSecurity est null.

Remarques

La méthode SetAccessControl applique des entrées de liste de contrôle d’accès (ACL) à un fichier qui représente la liste ACL non utilisée.

Prudence

La liste de contrôle d’accès spécifiée pour le paramètre fileSecurity remplace la liste de contrôle d’accès existante pour le fichier. Pour ajouter des autorisations pour un nouvel utilisateur, utilisez la méthode GetAccessControl pour obtenir la liste de contrôle d’accès existante, la modifier, puis utilisez SetAccessControl pour l’appliquer au 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.

La méthode SetAccessControl conserve uniquement FileSecurity objets qui ont été modifiés après la création de l’objet. Si un objet FileSecurity n’a pas été modifié, il ne sera pas conservé dans un fichier. Par conséquent, il n’est pas possible de récupérer un objet FileSecurity à partir d’un fichier et de réappliquer le même objet à un autre fichier.

Pour copier des informations de liste de contrôle d’accès d’un fichier vers un autre :

1. Utilisez la méthode GetAccessControl pour récupérer l’objet FileSecurity à partir du fichier source.

2. Créez un objet FileSecurity pour le fichier de destination.

3. Utilisez la méthode GetSecurityDescriptorBinaryForm ou GetSecurityDescriptorSddlForm de l’objet FileSecurity source pour récupérer les informations de liste de contrôle d’accès.

4. Utilisez la méthode SetSecurityDescriptorBinaryForm ou SetSecurityDescriptorSddlForm pour copier les informations récupérées à l’étape 3 dans l’objet FileSecurity de destination.

5. Définissez l’objet FileSecurity de destination sur le fichier de destination à l’aide de la méthode SetAccessControl.

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.

Voir aussi

• FileSystemWatcher