FileSecurity Constructeurs

Définition

Espace de noms:

System.Security.AccessControl

Assembly:

System.IO.FileSystem.AccessControl.dll

Initialise une nouvelle instance de la classe FileSecurity.

Surcharges

FileSecurity()	Initialise une nouvelle instance de la classe FileSecurity.
FileSecurity(String, AccessControlSections)	Initialise une nouvelle instance de la classe FileSecurity à partir d'un fichier spécifié à l'aide des valeurs spécifiées de l'énumération AccessControlSections.

FileSecurity()

Initialise une nouvelle instance de la classe FileSecurity.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Exceptions

PlatformNotSupportedException

Le système d'exploitation actuel n'est pas Microsoft Windows 2000 ou ultérieur.

Remarques

Utilisez ce constructeur lorsque vous souhaitez créer un objet vide FileSecurity qui n’est pas basé sur un fichier existant. Vous pouvez ensuite remplir l’objet avec des informations de contrôle d’accès et les appliquer à un fichier.

Vous pouvez ajouter des règles d’accès ou d’audit à l’objet à l’aide FileSecurity de la AddAccessRule méthode . Vous pouvez supprimer des règles d’accès ou d’audit à l’aide de la RemoveAccessRule méthode .

Pour conserver des règles d’accès ou d’audit nouvelles ou modifiées dans un fichier, utilisez la SetAccessControl méthode ou SetAccessControl . Pour récupérer des règles d’accès ou d’audit à partir d’un fichier existant, utilisez la GetAccessControl méthode ou GetAccessControl .

FileSecurity(String, AccessControlSections)

Initialise une nouvelle instance de la classe FileSecurity à partir d'un fichier spécifié à l'aide des valeurs spécifiées de l'énumération AccessControlSections.

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

new System.Security.AccessControl.FileSecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Sub New (fileName As String, includeSections As AccessControlSections)

Paramètres

fileName

String

Emplacement du fichier à partir duquel créer un objet FileSecurity.

includeSections

AccessControlSections

Une des valeurs AccessControlSections qui spécifie le type d'informations ACL à récupérer.

Exceptions

ArgumentException

Le paramètre fileName est une chaîne de longueur nulle, contient seulement un espace, ou contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

FileNotFoundException

Le fichier spécifié dans le paramètre fileName est introuvable.

IOException

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

NotSupportedException

path est dans un format non valide.

SEHException

Le paramètre fileName a la valeur null.

PlatformNotSupportedException

Le système d'exploitation actuel n'est pas Microsoft Windows 2000 ou ultérieur.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

PrivilegeNotHeldException

Le compte système actuel ne dispose pas de privilèges d’administrateur.

SystemException

Le fichier est introuvable.

UnauthorizedAccessException

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

- ou -

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

- ou -

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

- ou -

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

Remarques

Ce constructeur récupère les informations de contrôle d’accès pour le fichier spécifié, puis crée un FileSecurity objet qui encapsule ces informations. Vous pouvez ensuite inspecter, ajouter ou supprimer les informations de contrôle d’accès pour le fichier spécifié.

Vous pouvez ajouter des règles d’accès ou d’audit à l’objet à l’aide FileSecurity de la AddAccessRule méthode . Vous pouvez supprimer des règles d’accès ou d’audit à l’aide de la RemoveAccessRule méthode .

Pour conserver des règles d’accès ou d’audit nouvelles ou modifiées dans un fichier, utilisez la SetAccessControl méthode ou SetAccessControl . Pour récupérer des règles d’accès ou d’audit à partir d’un fichier existant, utilisez la GetAccessControl méthode ou GetAccessControl .

Notes pour les appelants

Le FileSecurity(String, AccessControlSections) constructeur exige que le compte actuel dispose de privilèges d’administration. Pour créer un instance de la FileSecurity classe pour un fichier spécifique à l’aide d’un compte qui ne dispose pas de privilèges d’administration, utilisez la GetAccessControl() méthode .