File.GetAccessControl Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient un objet FileSecurity qui encapsule les entrées ACL pour un fichier spécifié.
Surcharges
GetAccessControl(String) |
Obtient un objet FileSecurity qui encapsule les entrées ACL pour un fichier spécifié. |
GetAccessControl(String, AccessControlSections) |
Obtient un objet FileSecurity qui encapsule le type spécifié des entrées ACL pour un fichier particulier. |
Remarques
Utilisez les GetAccessControl méthodes pour récupérer les entrées de liste de contrôle d’accès (ACL) pour un fichier spécifié.
GetAccessControl(String)
Obtient un objet FileSecurity qui encapsule les entrées 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 ACL du fichier.
Retours
Objet FileSecurity qui encapsule les règles de contrôle d'accès pour le fichier décrit par le paramètre path
.
Exceptions
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
Le paramètre path
a la valeur null
.
Le fichier est introuvable.
Le paramètre path
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
path
a spécifié un répertoire.ou - L'appelant n'a pas l'autorisation requise.
Exemples
L’exemple de code suivant utilise les GetAccessControl SetAccessControl méthodes et pour ajouter et supprimer une entrée de liste de contrôle d’accès (ACL) dans un fichier. Vous devez entrer un compte d'utilisateur ou de groupe valide pour exécuter cet exemple.
using namespace System;
using namespace System::IO;
using namespace System::Security::AccessControl;
// Adds an ACL entry on the specified file for the specified account.
void AddFileSecurity(String^ fileName, String^ account,
FileSystemRights rights, AccessControlType controlType)
{
// Get a FileSecurity object that represents the
// current security settings.
FileSecurity^ fSecurity = File::GetAccessControl(fileName);
// Add the FileSystemAccessRule to the security settings.
fSecurity->AddAccessRule(gcnew FileSystemAccessRule
(account,rights, controlType));
// Set the new access settings.
File::SetAccessControl(fileName, fSecurity);
}
// Removes an ACL entry on the specified file for the specified account.
void RemoveFileSecurity(String^ fileName, String^ account,
FileSystemRights rights, AccessControlType controlType)
{
// Get a FileSecurity object that represents the
// current security settings.
FileSecurity^ fSecurity = File::GetAccessControl(fileName);
// Remove the FileSystemAccessRule from the security settings.
fSecurity->RemoveAccessRule(gcnew FileSystemAccessRule
(account,rights, controlType));
// Set the new access settings.
File::SetAccessControl(fileName, fSecurity);
}
int main()
{
try
{
String^ fileName = "test.xml";
Console::WriteLine("Adding access control entry for " + fileName);
// Add the access control entry to the file.
AddFileSecurity(fileName, "MYDOMAIN\\MyAccount",
FileSystemRights::ReadData, AccessControlType::Allow);
Console::WriteLine("Removing access control entry from " + fileName);
// Remove the access control entry from the file.
RemoveFileSecurity(fileName, "MYDOMAIN\\MyAccount",
FileSystemRights::ReadData, AccessControlType::Allow);
Console::WriteLine("Done.");
}
catch (Exception^ ex)
{
Console::WriteLine(ex->Message);
}
}
using System;
using System.IO;
using System.Security.AccessControl;
namespace FileSystemExample
{
class FileExample
{
public static void Main()
{
try
{
string fileName = "test.xml";
Console.WriteLine("Adding access control entry for "
+ fileName);
// Add the access control entry to the file.
AddFileSecurity(fileName, @"DomainName\AccountName",
FileSystemRights.ReadData, AccessControlType.Allow);
Console.WriteLine("Removing access control entry from "
+ fileName);
// Remove the access control entry from the file.
RemoveFileSecurity(fileName, @"DomainName\AccountName",
FileSystemRights.ReadData, AccessControlType.Allow);
Console.WriteLine("Done.");
}
catch (Exception e)
{
Console.WriteLine(e);
}
}
// Adds an ACL entry on the specified file for the specified account.
public static void AddFileSecurity(string fileName, string account,
FileSystemRights rights, AccessControlType controlType)
{
// Get a FileSecurity object that represents the
// current security settings.
FileSecurity fSecurity = File.GetAccessControl(fileName);
// Add the FileSystemAccessRule to the security settings.
fSecurity.AddAccessRule(new FileSystemAccessRule(account,
rights, controlType));
// Set the new access settings.
File.SetAccessControl(fileName, fSecurity);
}
// Removes an ACL entry on the specified file for the specified account.
public static void RemoveFileSecurity(string fileName, string account,
FileSystemRights rights, AccessControlType controlType)
{
// Get a FileSecurity object that represents the
// current security settings.
FileSecurity fSecurity = File.GetAccessControl(fileName);
// Remove the FileSystemAccessRule from the security settings.
fSecurity.RemoveAccessRule(new FileSystemAccessRule(account,
rights, controlType));
// Set the new access settings.
File.SetAccessControl(fileName, fSecurity);
}
}
}
Imports System.IO
Imports System.Security.AccessControl
Module FileExample
Sub Main()
Try
Dim fileName As String = "test.xml"
Console.WriteLine("Adding access control entry for " & fileName)
' Add the access control entry to the file.
AddFileSecurity(fileName, "DomainName\AccountName", _
FileSystemRights.ReadData, AccessControlType.Allow)
Console.WriteLine("Removing access control entry from " & fileName)
' Remove the access control entry from the file.
RemoveFileSecurity(fileName, "DomainName\AccountName", _
FileSystemRights.ReadData, AccessControlType.Allow)
Console.WriteLine("Done.")
Catch e As Exception
Console.WriteLine(e)
End Try
End Sub
' Adds an ACL entry on the specified file for the specified account.
Sub AddFileSecurity(ByVal fileName As String, ByVal account As String, _
ByVal rights As FileSystemRights, ByVal controlType As AccessControlType)
' Get a FileSecurity object that represents the
' current security settings.
Dim fSecurity As FileSecurity = File.GetAccessControl(fileName)
' Add the FileSystemAccessRule to the security settings.
Dim accessRule As FileSystemAccessRule = _
New FileSystemAccessRule(account, rights, controlType)
fSecurity.AddAccessRule(accessRule)
' Set the new access settings.
File.SetAccessControl(fileName, fSecurity)
End Sub
' Removes an ACL entry on the specified file for the specified account.
Sub RemoveFileSecurity(ByVal fileName As String, ByVal account As String, _
ByVal rights As FileSystemRights, ByVal controlType As AccessControlType)
' Get a FileSecurity object that represents the
' current security settings.
Dim fSecurity As FileSecurity = File.GetAccessControl(fileName)
' Remove the FileSystemAccessRule from the security settings.
fSecurity.RemoveAccessRule(New FileSystemAccessRule(account, _
rights, controlType))
' Set the new access settings.
File.SetAccessControl(fileName, fSecurity)
End Sub
End Module
Remarques
Utilisez la GetAccessControl méthode pour récupérer les entrées de la liste de contrôle d’accès (ACL) d’un fichier.
Une liste de contrôle d’accès décrit les individus et/ou les groupes qui possèdent ou non des droits sur des actions spécifiques sur le fichier donné. Pour plus d'informations, consultez Comment : ajouter ou supprimer des entrées dans la liste de contrôle d'accès.
Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur dispose ListDirectory de droits sur le dossier parent. Pour refuser ReadAttributes et ReadExtendedAttributes , refuser ListDirectory sur le répertoire parent.
S’applique à
GetAccessControl(String, AccessControlSections)
Obtient un objet FileSecurity qui encapsule le type spécifié des entrées 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 ACL du fichier.
- includeSections
- AccessControlSections
Une des valeurs AccessControlSections qui spécifie le type d'informations ACL à recevoir.
Retours
Objet FileSecurity qui encapsule les règles de contrôle d'accès pour le fichier décrit par le paramètre path
.
Exceptions
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
Le paramètre path
a la valeur null
.
Le fichier est introuvable.
Le paramètre path
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
path
a spécifié un répertoire.ou - L'appelant n'a pas l'autorisation requise.
Remarques
Utilisez la GetAccessControl méthode pour récupérer les entrées de la liste de contrôle d’accès (ACL) d’un fichier.
Une liste de contrôle d’accès décrit les individus et/ou les groupes qui possèdent ou non des droits sur des actions spécifiques sur le fichier donné. Pour plus d'informations, consultez Comment : ajouter ou supprimer des entrées dans la liste de contrôle d'accès.
Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur dispose ListDirectory de droits sur le dossier parent. Pour refuser ReadAttributes et ReadExtendedAttributes , refuser ListDirectory sur le répertoire parent.