IsolatedStorageFile Classe

Définition

Espace de noms:

System.IO.IsolatedStorage

Assemblys:

netstandard.dll, System.IO.IsolatedStorage.dll

Source:

IsolatedStorageFile.cs

Représente une zone de stockage isolée contenant des fichiers et des répertoires.

public ref class IsolatedStorageFile sealed : System::IO::IsolatedStorage::IsolatedStorage, IDisposable

public sealed class IsolatedStorageFile : System.IO.IsolatedStorage.IsolatedStorage, IDisposable

type IsolatedStorageFile = class
    inherit IsolatedStorage
    interface IDisposable

Public NotInheritable Class IsolatedStorageFile
Inherits IsolatedStorage
Implements IDisposable

Héritage

Object

MarshalByRefObject

IsolatedStorage

IsolatedStorageFile

Implémente

IDisposable

Exemples

L’exemple de code suivant montre comment créer des fichiers et des répertoires dans un magasin isolé. Tout d’abord, un magasin isolé par l’utilisateur, le domaine et l’assembly sont récupérés et placés dans la isoStore variable. La CreateDirectory méthode est ensuite appelée pour créer des répertoires, et deux instances de la IsolatedStorageFileStream classe créent des fichiers dans ces répertoires.

using System;
using System.IO;
using System.IO.IsolatedStorage;

public class CreatingFilesDirectories
{
    public static void Main()
    {
        using (IsolatedStorageFile isoStore = IsolatedStorageFile.GetStore(IsolatedStorageScope.User | IsolatedStorageScope.Domain | IsolatedStorageScope.Assembly, null, null))
        {
            isoStore.CreateDirectory("TopLevelDirectory");
            isoStore.CreateDirectory("TopLevelDirectory/SecondLevel");
            isoStore.CreateDirectory("AnotherTopLevelDirectory/InsideDirectory");
            Console.WriteLine("Created directories.");

            isoStore.CreateFile("InTheRoot.txt");
            Console.WriteLine("Created a new file in the root.");

            isoStore.CreateFile("AnotherTopLevelDirectory/InsideDirectory/HereIAm.txt");
            Console.WriteLine("Created a new file in the InsideDirectory.");
        }
    }
}

Imports System.IO
Imports System.IO.IsolatedStorage

Module Module1
    Sub Main()
        Using isoStore As IsolatedStorageFile = IsolatedStorageFile.GetStore(IsolatedStorageScope.User Or IsolatedStorageScope.Assembly Or IsolatedStorageScope.Domain, Nothing, Nothing)

            isoStore.CreateDirectory("TopLevelDirectory")
            isoStore.CreateDirectory("TopLevelDirectory/SecondLevel")
            isoStore.CreateDirectory("AnotherTopLevelDirectory/InsideDirectory")
            Console.WriteLine("Created directories.")

            isoStore.CreateFile("InTheRoot.txt")
            Console.WriteLine("Created a new file in the root.")

            isoStore.CreateFile("AnotherTopLevelDirectory/InsideDirectory/HereIAm.txt")
            Console.WriteLine("Created a new file in the InsideDirectory.")
        End Using
    End Sub
End Module

Remarques

Cet objet correspond à une étendue de stockage isolée spécifique, où des fichiers représentés par IsolatedStorageFileStream des objets existent. Les applications peuvent utiliser un stockage isolé pour enregistrer des données dans leur propre partie isolée du système de fichiers, sans avoir à spécifier un chemin particulier dans le système de fichiers. Étant donné que les magasins isolés sont limités à des assemblys particuliers, la plupart des autres codes managés ne pourront pas accéder aux données de votre code (des outils d’administration et de code managé hautement approuvés peuvent accéder aux magasins à partir d’autres assemblys). Le code non managé peut accéder à n’importe quel magasin isolé.

Pour plus d’informations, consultez Stockage isolé.

Ce type implémente l’interface IDisposable . Une fois que vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type, appelez sa Dispose méthode dans un try/catch bloc. Pour la supprimer indirectement, utilisez une construction de langage telle que using (en C#) ou Using (en Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet implémentant IDisposable » dans la rubrique d’interface IDisposable .

Propriétés

Nom	Description
ApplicationIdentity	Obtient une identité d’application qui étend le stockage isolé. (Hérité de IsolatedStorage)
AssemblyIdentity	Obtient une identité d’assembly utilisée pour étendre le stockage isolé. (Hérité de IsolatedStorage)
AvailableFreeSpace	Obtient une valeur qui représente la quantité d’espace libre disponible pour le stockage isolé.
CurrentSize	Obsolète. Obtient la taille actuelle du stockage isolé.
DomainIdentity	Obtient une identité de domaine qui étend le stockage isolé. (Hérité de IsolatedStorage)
IsEnabled	Obtient une valeur qui indique si le stockage isolé est activé.
MaximumSize	Obsolète. Obtient une valeur représentant la quantité maximale d’espace disponible pour le stockage isolé dans les limites établies par le quota.
Quota	Obtient une valeur qui représente la quantité maximale d’espace disponible pour le stockage isolé.
Scope	Obtient une valeur d’énumération IsolatedStorageScope spécifiant l’étendue utilisée pour isoler le magasin. (Hérité de IsolatedStorage)
SeparatorExternal	Obtient un caractère de barre oblique inverse qui peut être utilisé dans une chaîne de répertoire. En cas de substitution dans une classe dérivée, un autre caractère peut être retourné. (Hérité de IsolatedStorage)
SeparatorInternal	Obtient un caractère de point qui peut être utilisé dans une chaîne de répertoire. En cas de substitution dans une classe dérivée, un autre caractère peut être retourné. (Hérité de IsolatedStorage)
UsedSize	Obtient une valeur qui représente la quantité d’espace utilisé pour le stockage isolé.

Méthodes

Nom	Description
Close()	Ferme un magasin précédemment ouvert avec GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly()ou GetUserStoreForDomain().
CopyFile(String, String, Boolean)	Copie un fichier existant dans un nouveau fichier et remplace éventuellement un fichier existant.
CopyFile(String, String)	Copie un fichier existant dans un nouveau fichier.
CreateDirectory(String)	Crée un répertoire dans l’étendue de stockage isolée.
CreateFile(String)	Crée un fichier dans le magasin isolé.
DeleteDirectory(String)	Supprime un répertoire dans l’étendue de stockage isolée.
DeleteFile(String)	Supprime un fichier dans l’étendue de stockage isolée.
DirectoryExists(String)	Détermine si le chemin spécifié fait référence à un répertoire existant dans le magasin isolé.
Dispose()	Libère toutes les ressources utilisées par le IsolatedStorageFile.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FileExists(String)	Détermine si le chemin spécifié fait référence à un fichier existant dans le magasin isolé.
GetCreationTime(String)	Retourne la date et l’heure de création d’un fichier ou d’un répertoire spécifiés.
GetDirectoryNames()	Énumère les répertoires à la racine d’un magasin isolé.
GetDirectoryNames(String)	Énumère les répertoires dans une étendue de stockage isolée qui correspondent à un modèle de recherche donné.
GetEnumerator(IsolatedStorageScope)	Obtient l’énumérateur pour les IsolatedStorageFile magasins dans une étendue de stockage isolée.
GetFileNames()	Énumère les noms de fichiers à la racine d’un magasin isolé.
GetFileNames(String)	Obtient les noms de fichiers qui correspondent à un modèle de recherche.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLastAccessTime(String)	Retourne la date et l’heure auxquelles un fichier ou répertoire spécifié a été consulté pour la dernière fois.
GetLastWriteTime(String)	Retourne la date et l’heure dans laquelle un fichier ou répertoire spécifié a été écrit pour la dernière fois.
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMachineStoreForApplication()	Obtient le stockage isolé délimité par l’ordinateur correspondant à l’identité de l’application du code appelant.
GetMachineStoreForAssembly()	Obtient le stockage isolé à portée de l’ordinateur correspondant à l’identité d’assembly du code appelant.
GetMachineStoreForDomain()	Obtient le stockage isolé à portée de l’ordinateur correspondant à l’identité de domaine d’application et à l’identité d’assembly.
GetStore(IsolatedStorageScope, Object, Object)	Obtient le stockage isolé correspondant aux objets de preuve d’assembly et de domaine d’application donnés.
GetStore(IsolatedStorageScope, Object)	Obtient un stockage isolé correspondant à l’identité de l’application donnée.
GetStore(IsolatedStorageScope, Type, Type)	Obtient un stockage isolé correspondant à l’étendue de stockage isolée en fonction du domaine d’application et des types de preuves d’assembly.
GetStore(IsolatedStorageScope, Type)	Obtient un stockage isolé correspondant à l’étendue d’isolation et à l’objet d’identité d’application.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUserStoreForApplication()	Obtient le stockage isolé délimité par l’utilisateur correspondant à l’identité de l’application du code appelant.
GetUserStoreForAssembly()	Obtient le stockage isolé délimité par l’utilisateur correspondant à l’identité d’assembly du code appelant.
GetUserStoreForDomain()	Obtient le stockage isolé délimité par l’utilisateur correspondant à l’identité de domaine d’application et à l’identité d’assembly.
GetUserStoreForSite()	Obtient un magasin isolé délimité par l’utilisateur pour une utilisation par les applications dans un domaine hôte virtuel.
IncreaseQuotaTo(Int64)	Permet à une application de demander explicitement une plus grande taille de quota, en octets.
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
InitStore(IsolatedStorageScope, Type, Type)	Initialise un nouvel IsolatedStorage objet. (Hérité de IsolatedStorage)
InitStore(IsolatedStorageScope, Type)	Initialise un nouvel IsolatedStorage objet. (Hérité de IsolatedStorage)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
MoveDirectory(String, String)	Déplace un répertoire spécifié et son contenu vers un nouvel emplacement.
MoveFile(String, String)	Déplace un fichier spécifié vers un nouvel emplacement et vous permet éventuellement de spécifier un nouveau nom de fichier.
OpenFile(String, FileMode, FileAccess, FileShare)	Ouvre un fichier en mode spécifié, avec l’accès en lecture/écriture et l’autorisation de partage spécifiés.
OpenFile(String, FileMode, FileAccess)	Ouvre un fichier en mode spécifié avec l’accès en lecture/écriture spécifié.
OpenFile(String, FileMode)	Ouvre un fichier en mode spécifié.
Remove()	Supprime l’étendue de stockage isolée et tout son contenu.
Remove(IsolatedStorageScope)	Supprime l’étendue de stockage isolée spécifiée pour toutes les identités.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Stockage isolé