FileSecurity Costruttori

Definizione

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 ();

Eccezioni

Il sistema operativo corrente non è Microsoft Windows 2000 o versione successiva.

Commenti

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

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

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5

FileSecurity(String, AccessControlSections)

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

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

Parametri

fileName
String

Percorso di un file da cui creare un oggetto FileSecurity.

includeSections
AccessControlSections

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

Eccezioni

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

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

Il file specificato nel parametro fileName non è stato trovato.

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

path è in un formato non valido.

Il parametro fileName è null.

Il sistema operativo corrente non è Microsoft Windows 2000 o versione successiva.

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

L'account di sistema corrente non dispone di privilegi amministrativi.

Impossibile trovare il file.

Il parametro fileName ha specificato un file di sola lettura.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

Il parametro fileName ha specificato una directory.

-o-

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 oggetto FileSecurity 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 metodo AddAccessRule. È possibile rimuovere le regole di accesso o di controllo usando il metodo RemoveAccessRule.

Note per i chiamanti

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

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5