FileIOPermission Classe

Definizione

public ref class FileIOPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission

public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[System.Serializable]
public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

[<System.Serializable>]
type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class FileIOPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

Ereditarietà

Object

CodeAccessPermission

FileIOPermission

Attributi

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implementazioni

IUnrestrictedPermission

Esempio

Negli esempi seguenti viene illustrato il codice che usa FileIOPermission. Dopo le due righe di codice seguenti, l'oggetto f rappresenta l'autorizzazione per leggere tutti i file nei dischi locali del computer client. L'esempio di codice richiede quindi l'autorizzazione per determinare se l'applicazione dispone dell'autorizzazione per leggere i file.

FileIOPermission^ f = gcnew FileIOPermission( PermissionState::None );
f->AllLocalFiles = FileIOPermissionAccess::Read;
try
{
    f->Demand();
}
catch (SecurityException^ s)
{
    Console::WriteLine(s->Message);
}

FileIOPermission f = new FileIOPermission(PermissionState.None);
f.AllLocalFiles = FileIOPermissionAccess.Read;
try
{
    f.Demand();
}
catch (SecurityException s)
{
    Console.WriteLine(s.Message);
}

Dim f As New FileIOPermission(PermissionState.None)
f.AllLocalFiles = FileIOPermissionAccess.Read
Try
    f.Demand()
Catch s As SecurityException
    Console.WriteLine(s.Message)
End Try

Dopo le due righe di codice, l'oggetto f2 rappresenta le autorizzazioni per leggere C:\test_r e leggere e scrivere su c:\example\out.txt. Read e Write rappresentano le autorizzazioni per file/cartelle, come descritto in precedenza. Dopo aver creato l'autorizzazione, il codice richiede l'autorizzazione per determinare se l'applicazione ha il diritto di leggere e scrivere nel file.

FileIOPermission^ f2 = gcnew FileIOPermission( FileIOPermissionAccess::Read,"C:\\test_r" );
f2->AddPathList( (FileIOPermissionAccess) (FileIOPermissionAccess::Write | FileIOPermissionAccess::Read), "C:\\example\\out.txt" );
try
{
    f2->Demand();
}
catch (SecurityException^ s)
{
    Console::WriteLine(s->Message);
}

FileIOPermission f2 = new FileIOPermission(FileIOPermissionAccess.Read, "C:\\test_r");
f2.AddPathList(FileIOPermissionAccess.Write | FileIOPermissionAccess.Read, "C:\\example\\out.txt");
try
{
    f2.Demand();
}
catch (SecurityException s)
{
    Console.WriteLine(s.Message);
}

Dim f2 As New FileIOPermission(FileIOPermissionAccess.Read, "C:\test_r")
f2.AddPathList(FileIOPermissionAccess.Write Or FileIOPermissionAccess.Read, "C:\example\out.txt")
Try
    f2.Demand()
Catch s As SecurityException
    Console.WriteLine(s.Message)
End Try

Commenti

Questa autorizzazione distingue tra i quattro tipi di accesso di I/O di file seguenti forniti da FileIOPermissionAccess:

• Read: accesso in lettura al contenuto del file o accesso alle informazioni sul file, ad esempio la durata o l'ora dell'ultima modifica.

• Write: accesso in scrittura al contenuto del file o accesso per modificare le informazioni sul file, ad esempio il nome. Consente anche l'eliminazione e la sovrascrittura.

• Append: possibilità di scrivere solo alla fine di un file. Nessuna capacità di lettura.

• PathDiscovery: accesso alle informazioni nel percorso stesso. Ciò consente di proteggere le informazioni riservate nel percorso, ad esempio i nomi utente, nonché le informazioni sulla struttura di directory visualizzata nel percorso. Questo valore non consente l'accesso ai file o alle cartelle rappresentate dal percorso.

Tutte queste autorizzazioni sono indipendenti, vale a dire che i diritti a uno non implicano diritti a un altro. Ad esempio, Write l'autorizzazione non implica l'autorizzazione per Read o Append. Se si desidera disporre di più autorizzazioni, è possibile combinare usando un OR bit per bit, come illustrato nell'esempio di codice seguente. L'autorizzazione file è definita in termini di percorsi assoluti canonici; le chiamate devono essere sempre effettuate con percorsi di file canonici.

FileIOPermission descrive le operazioni protette su file e cartelle. La File classe consente di fornire accesso sicuro a file e cartelle. Il controllo di accesso di sicurezza viene eseguito quando viene creato l'handle per il file. Eseguendo il controllo in fase di creazione, l'impatto sulle prestazioni del controllo di sicurezza è ridotto al minimo. L'apertura di un file avviene una sola volta, mentre la lettura e la scrittura possono verificarsi più volte. Una volta aperto il file, non vengono eseguiti ulteriori controlli. Se l'oggetto viene passato a un chiamante non attendibile, può essere usato in modo improprio. Ad esempio, gli handle di file non devono essere archiviati in statici globali pubblici in cui il codice con meno autorizzazioni può accedervi.

FileIOPermissionAccess specifica le azioni che possono essere eseguite nel file o nella cartella. Inoltre, queste azioni possono essere combinate usando un OR bit per bit per formare istanze complesse.

L'accesso a una cartella implica l'accesso a tutti i file contenuti, nonché l'accesso a tutti i file e alle cartelle nelle relative sottocartelle. Ad esempio, Read l'accesso a C:\folder1\ implica Read l'accesso a C:\folder1\file1.txt, C:\folder1\folder2\, C:\folder1\folder2\file2.txt e così via.

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• FileIOPermissionAccess
• FileIOPermissionAttribute