FileSecurity Costruttori

Definizione

Inizializza una nuova istanza della classe FileSecurity.Initializes a new instance of the FileSecurity class.

Overload

FileSecurity()

Inizializza una nuova istanza della classe FileSecurity.Initializes a new instance of the FileSecurity class.

FileSecurity(String, AccessControlSections)

Inizializza una nuova istanza della classe FileSecurity da un file specificato utilizzando i valori specificati dell'enumerazione AccessControlSections.Initializes a new instance of the FileSecurity class from a specified file using the specified values of the AccessControlSections enumeration.

FileSecurity()

Inizializza una nuova istanza della classe FileSecurity.Initializes a new instance of the FileSecurity class.

public:
 FileSecurity();
public FileSecurity ();
Public Sub New ()

Eccezioni

Il sistema operativo corrente non è Microsoft Windows 2000 o versioni successive.The current operating system is not Microsoft Windows 2000 or later.

Commenti

Utilizzare questo costruttore quando si desidera creare un oggetto vuoto FileSecurity che non si basa su un file esistente.Use this constructor when you want to create an empty FileSecurity object that is not based on an existing file. È quindi possibile popolare l'oggetto con le informazioni di controllo di accesso e applicarlo a un file.You can then populate the object with access control information and apply it to a file.

È possibile aggiungere regole di accesso o di controllo all' FileSecurity oggetto usando il AddAccessRule metodo.You can add access or audit rules to the FileSecurity object using the AddAccessRule method. È possibile rimuovere le regole di accesso o di controllo utilizzando il RemoveAccessRule metodo.You can remove access or audit rules using the RemoveAccessRule method.

Per salvare le regole di accesso o di controllo nuove o modificate in un file, usare il SetAccessControl SetAccessControl metodo o.To persist new or changed access or audit rules to a file, use the SetAccessControl or SetAccessControl method. Per recuperare le regole di accesso o di controllo da un file esistente, usare il GetAccessControl GetAccessControl metodo o.To retrieve access or audit rules from an existing file, use the GetAccessControl or GetAccessControl method.

Si applica a

FileSecurity(String, AccessControlSections)

Inizializza una nuova istanza della classe FileSecurity da un file specificato utilizzando i valori specificati dell'enumerazione AccessControlSections.Initializes a new instance of the FileSecurity class from a specified file using the specified values of the AccessControlSections enumeration.

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.The location of a file to create a FileSecurity object from.

includeSections
AccessControlSections

Uno dei valori AccessControlSections che specifica il tipo di informazioni relative all'elenco di controllo di accesso da recuperare.One of the AccessControlSections values that specifies the type of access control list (ACL) information to retrieve.

Eccezioni

Il parametro fileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.The fileName parameter is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid, (for example, it is on an unmapped drive).

Impossibile trovare il file specificato dal parametro fileName.The file specified in the fileName parameter was not found.

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

Il formato di path non è valido.path is in an invalid format.

Il valore del parametro fileName è null.The fileName parameter is null.

Il sistema operativo corrente non è Microsoft Windows 2000 o versioni successive.The current operating system is not Microsoft Windows 2000 or later.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

L'account di sistema corrente non ha privilegi amministrativi.The current system account does not have administrative privileges.

Il file non è stato trovato.The file could not be found.

Il parametro fileName specifica un file di sola lettura.The fileName parameter specified a file that is read-only.

-oppure--or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

-oppure--or- Il parametro fileName specifica una directory.The fileName parameter specified a directory.

-oppure--or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Commenti

Questo costruttore recupera le informazioni sul controllo di accesso per il file specificato e quindi crea un FileSecurity oggetto che incapsula tali informazioni.This constructor retrieves the access control information for the specified file and then creates a FileSecurity object that encapsulates that information. È quindi possibile ispezionare, aggiungere o eliminare le informazioni sul controllo di accesso per il file specificato.You can then inspect, add, or delete the access control information for the specified file.

È possibile aggiungere regole di accesso o di controllo all' FileSecurity oggetto usando il AddAccessRule metodo.You can add access or audit rules to the FileSecurity object using the AddAccessRule method. È possibile rimuovere le regole di accesso o di controllo utilizzando il RemoveAccessRule metodo.You can remove access or audit rules using the RemoveAccessRule method.

Per salvare le regole di accesso o di controllo nuove o modificate in un file, usare il SetAccessControl SetAccessControl metodo o.To persist new or changed access or audit rules to a file, use the SetAccessControl or SetAccessControl method. Per recuperare le regole di accesso o di controllo da un file esistente, usare il GetAccessControl GetAccessControl metodo o.To retrieve access or audit rules from an existing file, use the GetAccessControl or GetAccessControl method.

Note per i chiamanti

Il FileSecurity(String, AccessControlSections) costruttore richiede che l'account corrente disponga di privilegi amministrativi.The FileSecurity(String, AccessControlSections) constructor requires the current account to have administrative privileges. Per creare una nuova istanza della FileSecurity classe per un file specifico utilizzando un account che non dispone di privilegi amministrativi, utilizzare il GetAccessControl() metodo.To create a new instance of the FileSecurity class for a specific file using an account that does not have administrative privileges, use the GetAccessControl() method.

Si applica a