FileSecurity Costruttori

Definizione

Spazio dei nomi:

System.Security.AccessControl

Assembly:

System.IO.FileSystem.AccessControl.dll

Inizializza una nuova istanza della classe FileSecurity.

Overload

FileSecurity()	Inizializza una nuova istanza della classe FileSecurity.
FileSecurity(String, AccessControlSections)	Inizializza una nuova istanza della classe FileSecurity da un file specificato utilizzando i valori specificati dell'enumerazione AccessControlSections.

FileSecurity()

Inizializza una nuova istanza della classe FileSecurity.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Eccezioni

PlatformNotSupportedException

Il sistema operativo corrente non è Microsoft Windows 2000 o versioni successive.

Commenti

Utilizzare questo costruttore quando si desidera creare un oggetto vuoto FileSecurity che non si basa su un file esistente. È quindi possibile popolare l'oggetto con le informazioni di controllo di accesso e applicarlo a un file.

È possibile aggiungere regole di accesso o controllo all'oggetto FileSecurity usando il AddAccessRule metodo . È possibile rimuovere le regole di accesso o di controllo usando il RemoveAccessRule metodo .

Per rendere persistenti le regole di accesso o controllo nuove o modificate in un file, usare il SetAccessControl metodo o SetAccessControl . Per recuperare le regole di accesso o controllo da un file esistente, usare il GetAccessControl metodo o GetAccessControl .

FileSecurity(String, AccessControlSections)

Inizializza una nuova istanza della classe FileSecurity da un file specificato utilizzando i valori specificati dell'enumerazione 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)

Parametri

fileName

String

Percorso del file da cui creare un oggetto FileSecurity.

includeSections

AccessControlSections

Uno dei valori AccessControlSections che specifica il tipo di informazioni relative all'elenco di controllo di accesso da recuperare.

Eccezioni

ArgumentException

Il parametro fileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

FileNotFoundException

Impossibile trovare il file specificato dal parametro fileName.

IOException

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

NotSupportedException

Il formato di path non è valido.

SEHException

Il valore del parametro fileName è null.

PlatformNotSupportedException

Il sistema operativo corrente non è Microsoft Windows 2000 o versioni successive.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

PrivilegeNotHeldException

L'account di sistema corrente non ha privilegi amministrativi.

SystemException

Il file non è stato trovato.

UnauthorizedAccessException

Il parametro fileName specifica un file di sola lettura.

-oppure-

L'operazione non è supportata sulla piattaforma corrente.

-oppure-

Il parametro fileName specifica una directory.

-oppure-

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Questo costruttore recupera le informazioni sul controllo di accesso per il file specificato e quindi crea un FileSecurity oggetto che incapsula tali informazioni. È quindi possibile esaminare, aggiungere o eliminare le informazioni sul controllo di accesso per il file specificato.

È possibile aggiungere regole di accesso o controllo all'oggetto FileSecurity usando il AddAccessRule metodo . È possibile rimuovere le regole di accesso o di controllo usando il RemoveAccessRule metodo .

Per rendere persistenti le regole di accesso o controllo nuove o modificate in un file, usare il SetAccessControl metodo o SetAccessControl . Per recuperare le regole di accesso o controllo da un file esistente, usare il GetAccessControl metodo o GetAccessControl .

Note per i chiamanti

Il FileSecurity(String, AccessControlSections) costruttore richiede che l'account corrente disponga dei privilegi amministrativi. Per creare una nuova istanza della FileSecurity classe per un file specifico usando un account che non dispone di privilegi amministrativi, usare il GetAccessControl() metodo .