File.GetAccessControl Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

mscorlib.dll

Ottiene un oggetto FileSecurity che incapsula le voci dell'elenco di controllo di accesso (ACL) per un file specificato.

Overload

GetAccessControl(String)	Ottiene un oggetto FileSecurity che incapsula le voci dell'elenco di controllo di accesso (ACL) per un file specificato.
GetAccessControl(String, AccessControlSections)	Ottiene un oggetto FileSecurity che incapsula il tipo specificato di voci dell'elenco di controllo di accesso (ACL) per un determinato file.

GetAccessControl(String)

Ottiene un oggetto FileSecurity che incapsula le voci dell'elenco di controllo di accesso (ACL) per un file specificato.

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

Parametri

path

String

Percorso di un file contenente un oggetto FileSecurity che descrive le informazioni dell'elenco di controllo di accesso (ACL) del file.

Restituisce

FileSecurity

Oggetto FileSecurity che incapsula le regole di controllo di accesso per il file descritto dal parametro path.

Eccezioni

IOException

Si è verificato un errore di I/O durante l'apertura del file.

SEHException

Il parametro path è null.

SystemException

Impossibile trovare il file.

UnauthorizedAccessException

Il parametro path ha specificato un file di sola lettura.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

Il parametro path ha specificato una directory.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Utilizzare il metodo GetAccessControl per recuperare le voci dell'elenco di controllo di accesso (ACL) per un file.

Un elenco di controllo di accesso descrive singoli utenti e gruppi che dispongono o non dispongono di diritti per azioni specifiche nel file specificato. Per altre informazioni, vedere Procedura: Aggiungere o rimuovere voci dell'elenco di controllo di accesso.

Negli ambienti NTFS, ReadAttributes e ReadExtendedAttributes vengono concessi all'utente se l'utente dispone di diritti di ListDirectory nella cartella padre. Per negare ReadAttributes e ReadExtendedAttributes, negare ListDirectory nella directory padre.

GetAccessControl(String, AccessControlSections)

Ottiene un oggetto FileSecurity che incapsula il tipo specificato di voci dell'elenco di controllo di accesso (ACL) per un determinato file.

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

Parametri

path

String

Percorso di un file contenente un oggetto FileSecurity che descrive le informazioni dell'elenco di controllo di accesso (ACL) del file.

includeSections

AccessControlSections

Uno dei valori AccessControlSections che specifica il tipo di informazioni dell'elenco di controllo di accesso (ACL) da ricevere.

Restituisce

FileSecurity

Oggetto FileSecurity che incapsula le regole di controllo di accesso per il file descritto dal parametro path.

Eccezioni

IOException

Si è verificato un errore di I/O durante l'apertura del file.

SEHException

Il parametro path è null.

SystemException

Impossibile trovare il file.

UnauthorizedAccessException

Il parametro path ha specificato un file di sola lettura.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

Il parametro path ha specificato una directory.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Utilizzare il metodo GetAccessControl per recuperare le voci dell'elenco di controllo di accesso (ACL) per un file.

Un elenco di controllo di accesso descrive singoli utenti e gruppi che dispongono o non dispongono di diritti per azioni specifiche nel file specificato. Per altre informazioni, vedere Procedura: Aggiungere o rimuovere voci dell'elenco di controllo di accesso.

Negli ambienti NTFS, ReadAttributes e ReadExtendedAttributes vengono concessi all'utente se l'utente dispone di diritti di ListDirectory nella cartella padre. Per negare ReadAttributes e ReadExtendedAttributes, negare ListDirectory nella directory padre.