FileIOPermission Classe

Définition

public ref class FileIOPermission sealed : 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

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}")>]
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

type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class FileIOPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

Héritage

Object

CodeAccessPermission

FileIOPermission

Attributs

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implémente

IUnrestrictedPermission

Exemples

Les exemples suivants illustrent le code qui utilise FileIOPermission. Après les deux lignes de code suivantes, l’objet f représente l’autorisation de lire tous les fichiers sur les disques locaux de l’ordinateur client. L’exemple de code demande ensuite l’autorisation pour déterminer si l’application est autorisée à lire les fichiers.

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

Après les deux lignes de code suivantes, l’objet f2 représente les autorisations pour lire C :\test_r et lire et écrire dans C:\example\out.txt. Read et Write représentent les autorisations de fichier/dossier comme décrit précédemment. Après avoir créé l’autorisation, le code demande l’autorisation pour déterminer si l’application a le droit de lire et d’écrire dans le fichier.

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

Remarques

Cette autorisation fait la distinction entre les quatre types d’accès d’E/S de fichier suivants fournis par FileIOPermissionAccess:

• Read: accès en lecture au contenu du fichier ou accès aux informations sur le fichier, telles que sa longueur ou l’heure de la dernière modification.

• Write: accès en écriture au contenu du fichier ou accès pour modifier les informations sur le fichier, telles que son nom. Autorise également la suppression et le remplacement.

• Append: possibilité d’écrire à la fin d’un fichier uniquement. Aucune capacité de lecture.

• PathDiscovery: accès aux informations dans le chemin d’accès lui-même. Cela permet de protéger les informations sensibles dans le chemin d’accès, telles que les noms d’utilisateur, ainsi que les informations sur la structure de répertoires qui sont révélées dans le chemin d’accès. Cette valeur n'accorde pas d'accès aux fichiers ou dossiers représentés par le chemin.

Toutes ces autorisations sont indépendantes, ce qui signifie que les droits à l’un n’impliquent pas des droits sur une autre. Par exemple, l’autorisation Write n’implique pas l’autorisation de Read ou Append. Si plusieurs autorisations sont souhaitées, elles peuvent être combinées à l’aide d’un or au niveau du bit, comme indiqué dans l’exemple de code qui suit. L’autorisation de fichier est définie en termes de chemins d’accès absolus canoniques ; Les appels doivent toujours être effectués avec des chemins de fichiers canoniques.

FileIOPermission décrit les opérations protégées sur les fichiers et dossiers. La File classe permet de fournir un accès sécurisé aux fichiers et dossiers. La case activée d’accès de sécurité est effectuée lors de la création du handle du fichier. En effectuant les case activée au moment de la création, l’impact sur les performances de l’case activée de sécurité est réduit au minimum. L’ouverture d’un fichier se produit une seule fois, tandis que la lecture et l’écriture peuvent se produire plusieurs fois. Une fois le fichier ouvert, aucune autre vérification n’est effectuée. Si l’objet est passé à un appelant non approuvé, il peut être utilisé à mauvais escient. Par exemple, les handles de fichier ne doivent pas être stockés dans des statiques globales publiques où le code avec moins d’autorisations peut y accéder.

FileIOPermissionAccess spécifie les actions qui peuvent être effectuées sur le fichier ou le dossier. En outre, ces actions peuvent être combinées à l’aide d’un or au niveau du bit pour former des instances complexes.

L’accès à un dossier implique l’accès à tous les fichiers qu’il contient, ainsi qu’à tous les fichiers et dossiers de ses sous-dossiers. Par exemple, Read l’accès à C :\folder1\ implique Read l’accès à C:\folder1\file1.txt, C :\folder1\folder2\, C:\folder1\folder2\file2.txt, etc.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• FileIOPermissionAccess
• FileIOPermissionAttribute