IsolatedStorageFile Класс

Определение

Предоставляет область изолированного хранилища, в которой содержатся файлы и каталоги.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
Наследование
IsolatedStorageFile
Наследование
Атрибуты
Реализации

Примеры

В примере кода ниже показано, как создавать файлы и каталоги в изолированном хранилище.The following code example illustrates how to create files and directories in an isolated store. Во-первых, хранилище, изолированное по пользователю, домену и сборке, извлекается и помещается в isoStore переменную.First, a store that is isolated by user, domain, and assembly is retrieved and placed in the isoStore variable. CreateDirectoryЗатем метод вызывается для создания каталогов, и два экземпляра IsolatedStorageFileStream класса создают файлы в этих каталогах.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

Комментарии

Этот объект соответствует определенной области изолированного хранения, где существуют файлы, представленные IsolatedStorageFileStream объектами.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.

Этот тип реализует интерфейс IDisposable.This type implements the IDisposable interface. По окончании использования выдаленную ему память следует прямо или косвенно освободить.When you have finished using the type, you should dispose of it either directly or indirectly. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Важно!

Изолированное хранилище недоступно для приложений Магазина Windows 8.x.Isolated storage is not available for Windows 8.x Store apps. Вместо этого используйте классы данных приложений в пространствах имен Windows.Storage, включенных в API среды выполнения Windows для хранения локальных данных и файлов.Instead, use the application data classes in the Windows.Storage namespaces included in the Windows Runtime API to store local data and files. Дополнительные сведения см. в статье Доступ к данным приложения в Центре разработки для Windows.For more information, see Application data in the Windows Dev Center.

Свойства

ApplicationIdentity

Возвращает удостоверение приложения, которое ограничивает область действия изолированного хранения.Gets an application identity that scopes isolated storage.

(Унаследовано от IsolatedStorage)
AssemblyIdentity

Возвращает удостоверение сборки, используемое для ограничения области действия изолированного хранения.Gets an assembly identity used to scope isolated storage.

(Унаследовано от 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.

(Унаследовано от IsolatedStorage)
CurrentSize
Является устаревшей.
Является устаревшей.

Получает текущий размер изолированного хранения.Gets the current size of the isolated storage.

DomainIdentity

Возвращает удостоверение домена, которое ограничивает область действия изолированного хранения.Gets a domain identity that scopes isolated storage.

(Унаследовано от IsolatedStorage)
IsEnabled

Получает значение, указывающее, включено ли изолированное хранилище.Gets a value that indicates whether isolated storage is enabled.

MaximumSize
Является устаревшей.
Является устаревшей.

Возвращает значение, представляющее максимальный размер области, доступной для изолированного хранения в пределах, установленных квотой.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.

(Унаследовано от IsolatedStorage)
Scope

Получает значение перечисления IsolatedStorageScope, ограничивающее область, используемую для изоляции хранилища.Gets an IsolatedStorageScope enumeration value specifying the scope used to isolate the store.

(Унаследовано от 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.

(Унаследовано от 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.

(Унаследовано от 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.

(Унаследовано от IsolatedStorage)

Методы

Close()

Закрывает хранилище, открытое ранее с помощью метода GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly() или GetUserStoreForDomain().Closes a store previously opened with GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly(), or GetUserStoreForDomain().

CopyFile(String, String)

Копирует существующий файл в новый файл.Copies an existing file to a new file.

CopyFile(String, String, Boolean)

Копирует существующий файл в новый файл и, возможно, перезаписывает существующий файл.Copies an existing file to a new file, and optionally overwrites an existing 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.

(Унаследовано от 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()

Освобождает все ресурсы, занятые модулем IsolatedStorageFile.Releases all resources used by the IsolatedStorageFile.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от 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)

Возвращает счетчик для хранилищ IsolatedStorageFile в области ограниченного действия изолированного хранения.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.

(Унаследовано от 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()
Является устаревшей.

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от 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.

(Унаследовано от 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)

Получает изолированное хранение, соответствующее данному удостоверению приложения.Obtains isolated storage corresponding to the given application identity.

GetStore(IsolatedStorageScope, Object, Object)

Возвращает изолированное хранение, соответствующее объектам данного домена приложения и свидетельства сборки.Obtains the isolated storage corresponding to the given application domain and assembly evidence objects.

GetStore(IsolatedStorageScope, Type)

Получает изолированное хранение, соответствующее области изоляции и объекту удостоверения приложения.Obtains isolated storage corresponding to the isolation scope and the application identity object.

GetStore(IsolatedStorageScope, Type, Type)

Получает изолированное хранение, соответствующее области ограниченного действия изолированного хранения, предоставляющей типы домена приложения и свидетельства сборки.Obtains isolated storage corresponding to the isolated storage scope given the application domain and assembly evidence types.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от 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.

(Унаследовано от IsolatedStorage)
InitializeLifetimeService()
Является устаревшей.

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
InitStore(IsolatedStorageScope, Type)

Инициализирует новый объект IsolatedStorage.Initializes a new IsolatedStorage object.

(Унаследовано от IsolatedStorage)
InitStore(IsolatedStorageScope, Type, Type)

Инициализирует новый объект IsolatedStorage.Initializes a new IsolatedStorage object.

(Унаследовано от IsolatedStorage)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от 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)

Открывает файл в заданном режиме.Opens a file in the specified mode.

OpenFile(String, FileMode, FileAccess)

Открывает файл в заданном режиме с заданным доступом для чтения и записи.Opens a file in the specified mode with the specified read/write access.

OpenFile(String, FileMode, FileAccess, FileShare)

Открывает файл в заданном режиме, с заданным уровнем доступа для чтения и записи и с разрешением на совместный доступ.Opens a file in the specified mode, with the specified read/write access and sharing permission.

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.

(Унаследовано от Object)

Применяется к