Edit

Share via


IsolatedStorageFile Class

Definition

Represents an isolated storage area containing files and directories.

public ref class IsolatedStorageFile sealed : IDisposable
public ref class IsolatedStorageFile sealed : System::IO::IsolatedStorage::IsolatedStorage, IDisposable
public sealed class IsolatedStorageFile : IDisposable
public sealed class IsolatedStorageFile : System.IO.IsolatedStorage.IsolatedStorage, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class IsolatedStorageFile : System.IO.IsolatedStorage.IsolatedStorage, IDisposable
type IsolatedStorageFile = class
    interface IDisposable
type IsolatedStorageFile = class
    inherit IsolatedStorage
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type IsolatedStorageFile = class
    inherit IsolatedStorage
    interface IDisposable
Public NotInheritable Class IsolatedStorageFile
Implements IDisposable
Public NotInheritable Class IsolatedStorageFile
Inherits IsolatedStorage
Implements IDisposable
Inheritance
IsolatedStorageFile
Inheritance
Attributes
Implements

Examples

The following code example illustrates how to create files and directories in an isolated store. First, a store that is isolated by user, domain, and assembly is retrieved and placed in the isoStore variable. The CreateDirectory method is then called to create directories, and two instances of the IsolatedStorageFileStream class create files in these directories.

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

Remarks

This object corresponds to a specific isolated storage scope, where files represented by IsolatedStorageFileStream objects exist. Applications can use isolated storage to save data in their own isolated portion of the file system, without having to specify a particular path within the file system. Since isolated stores are scoped to particular assemblies, most other managed code will not be able to access your code's data (highly trusted managed code and administration tools can access stores from other assemblies). Unmanaged code can access any isolated stores.

For more information, see Isolated Storage.

This type implements the IDisposable interface. When you have finished using the type, you should dispose of it either directly or indirectly. To dispose of the type directly, call its Dispose method in a try/catch block. To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Important

Isolated storage is not available for Windows 8.x Store apps. Instead, use the application data classes in the Windows.Storage namespaces included in the Windows Runtime API to store local data and files. For more information, see Application data in the Windows Dev Center.

Properties

ApplicationIdentity

Gets an application identity that scopes isolated storage.

(Inherited from IsolatedStorage)
AssemblyIdentity

Gets an assembly identity used to scope isolated storage.

(Inherited from IsolatedStorage)
AvailableFreeSpace

Gets a value that represents the amount of free space available for isolated storage.

AvailableFreeSpace

When overridden in a derived class, gets the available free space for isolated storage, in bytes.

(Inherited from IsolatedStorage)
CurrentSize
Obsolete.
Obsolete.

Gets the current size of the isolated storage.

DomainIdentity

Gets a domain identity that scopes isolated storage.

(Inherited from IsolatedStorage)
IsEnabled

Gets a value that indicates whether isolated storage is enabled.

MaximumSize
Obsolete.
Obsolete.

Gets a value representing the maximum amount of space available for isolated storage within the limits established by the quota.

Quota

Gets a value that represents the maximum amount of space available for isolated storage.

Quota

When overridden in a derived class, gets a value that represents the maximum amount of space available for isolated storage.

(Inherited from IsolatedStorage)
Scope

Gets an IsolatedStorageScope enumeration value specifying the scope used to isolate the store.

(Inherited from IsolatedStorage)
SeparatorExternal

Gets a backslash character that can be used in a directory string. When overridden in a derived class, another character might be returned.

(Inherited from IsolatedStorage)
SeparatorInternal

Gets a period character that can be used in a directory string. When overridden in a derived class, another character might be returned.

(Inherited from IsolatedStorage)
UsedSize

Gets a value that represents the amount of the space used for isolated storage.

UsedSize

When overridden in a derived class, gets a value that represents the amount of the space used for isolated storage.

(Inherited from IsolatedStorage)

Methods

Close()

Closes a store previously opened with GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly(), or GetUserStoreForDomain().

CopyFile(String, String, Boolean)

Copies an existing file to a new file, and optionally overwrites an existing file.

CopyFile(String, String)

Copies an existing file to a new file.

CreateDirectory(String)

Creates a directory in the isolated storage scope.

CreateFile(String)

Creates a file in the isolated store.

CreateObjRef(Type)

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeleteDirectory(String)

Deletes a directory in the isolated storage scope.

DeleteFile(String)

Deletes a file in the isolated storage scope.

DirectoryExists(String)

Determines whether the specified path refers to an existing directory in the isolated store.

Dispose()

Releases all resources used by the IsolatedStorageFile.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
FileExists(String)

Determines whether the specified path refers to an existing file in the isolated store.

Finalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetCreationTime(String)

Returns the creation date and time of a specified file or directory.

GetDirectoryNames()

Enumerates the directories at the root of an isolated store.

GetDirectoryNames(String)

Enumerates the directories in an isolated storage scope that match a given search pattern.

GetEnumerator(IsolatedStorageScope)

Gets the enumerator for the IsolatedStorageFile stores within an isolated storage scope.

GetFileNames()

Enumerates the file names at the root of an isolated store.

GetFileNames(String)

Gets the file names that match a search pattern.

GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetLastAccessTime(String)

Returns the date and time a specified file or directory was last accessed.

GetLastWriteTime(String)

Returns the date and time a specified file or directory was last written to.

GetLifetimeService()
Obsolete.

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMachineStoreForApplication()

Obtains machine-scoped isolated storage corresponding to the calling code's application identity.

GetMachineStoreForAssembly()

Obtains machine-scoped isolated storage corresponding to the calling code's assembly identity.

GetMachineStoreForDomain()

Obtains machine-scoped isolated storage corresponding to the application domain identity and the assembly identity.

GetPermission(PermissionSet)

When implemented by a derived class, returns a permission that represents access to isolated storage from within a permission set.

(Inherited from IsolatedStorage)
GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type)

Obtains isolated storage corresponding to the given application domain and the assembly evidence objects and types.

GetStore(IsolatedStorageScope, Object, Object)

Obtains the isolated storage corresponding to the given application domain and assembly evidence objects.

GetStore(IsolatedStorageScope, Object)

Obtains isolated storage corresponding to the given application identity.

GetStore(IsolatedStorageScope, Type, Type)

Obtains isolated storage corresponding to the isolated storage scope given the application domain and assembly evidence types.

GetStore(IsolatedStorageScope, Type)

Obtains isolated storage corresponding to the isolation scope and the application identity object.

GetType()

Gets the Type of the current instance.

(Inherited from Object)
GetUserStoreForApplication()

Obtains user-scoped isolated storage corresponding to the calling code's application identity.

GetUserStoreForAssembly()

Obtains user-scoped isolated storage corresponding to the calling code's assembly identity.

GetUserStoreForDomain()

Obtains user-scoped isolated storage corresponding to the application domain identity and assembly identity.

GetUserStoreForSite()

Obtains a user-scoped isolated store for use by applications in a virtual host domain.

IncreaseQuotaTo(Int64)

Enables an application to explicitly request a larger quota size, in bytes.

IncreaseQuotaTo(Int64)

When overridden in a derived class, prompts a user to approve a larger quota size, in bytes, for isolated storage.

(Inherited from IsolatedStorage)
InitializeLifetimeService()
Obsolete.

Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
InitStore(IsolatedStorageScope, Type, Type)

Initializes a new IsolatedStorage object.

(Inherited from IsolatedStorage)
InitStore(IsolatedStorageScope, Type)

Initializes a new IsolatedStorage object.

(Inherited from IsolatedStorage)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveDirectory(String, String)

Moves a specified directory and its contents to a new location.

MoveFile(String, String)

Moves a specified file to a new location, and optionally lets you specify a new file name.

OpenFile(String, FileMode, FileAccess, FileShare)

Opens a file in the specified mode, with the specified read/write access and sharing permission.

OpenFile(String, FileMode, FileAccess)

Opens a file in the specified mode with the specified read/write access.

OpenFile(String, FileMode)

Opens a file in the specified mode.

Remove()

Removes the isolated storage scope and all its contents.

Remove(IsolatedStorageScope)

Removes the specified isolated storage scope for all identities.

ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also