IsolatedStorageFile Класс

Определение

Пространство имен:

System.IO.IsolatedStorage

Сборка:

System.IO.IsolatedStorage.dll

Исходный код:

IsolatedStorageFile.cs

Предоставляет область изолированного хранилища, в которой содержатся файлы и каталоги.

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

Наследование

Object

MarshalByRefObject

IsolatedStorage

IsolatedStorageFile

Реализации

IDisposable

Примеры

В примере кода ниже показано, как создавать файлы и каталоги в изолированном хранилище. Сначала извлекается хранилище, изолированное пользователем, доменом и сборкой isoStore , и помещается в переменную . Затем CreateDirectory вызывается метод для создания каталогов, а два экземпляра IsolatedStorageFileStream класса создают файлы в этих каталогах.

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

Для получения дополнительной информации см. Изолированное хранилище.

Этот тип реализует интерфейс IDisposable. По окончании использования выдаленную ему память следует прямо или косвенно освободить. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.

Важно!

Изолированное хранилище недоступно для приложений Магазина Windows 8.x. Вместо этого используйте классы данных приложений в пространствах имен Windows.Storage, включенных в API среды выполнения Windows для хранения локальных данных и файлов. Дополнительные сведения см. в статье Доступ к данным приложения в Центре разработки для Windows.

Свойства

ApplicationIdentity	Возвращает удостоверение приложения, которое ограничивает область действия изолированного хранения. (Унаследовано от IsolatedStorage)
AssemblyIdentity	Возвращает удостоверение сборки, используемое для ограничения области действия изолированного хранения. (Унаследовано от IsolatedStorage)
AvailableFreeSpace	Получает значение, показывающее объем свободного пространства, доступного для изолированного хранилища.
CurrentSize	Устаревшие.. Получает текущий размер изолированного хранения.
DomainIdentity	Возвращает удостоверение домена, которое ограничивает область действия изолированного хранения. (Унаследовано от IsolatedStorage)
IsEnabled	Получает значение, указывающее, включено ли изолированное хранилище.
MaximumSize	Устаревшие.. Возвращает значение, представляющее максимальный размер области, доступной для изолированного хранения в пределах, установленных квотой.
Quota	Получает значение, представляющее максимальный объем свободного пространства, доступного для изолированной памяти.
Scope	Получает значение перечисления IsolatedStorageScope, ограничивающее область, используемую для изоляции хранилища. (Унаследовано от IsolatedStorage)
SeparatorExternal	Возвращает знак обратной косой черты, который можно использовать в строке каталога. При переопределении в производном классе может быть возвращен другой знак. (Унаследовано от IsolatedStorage)
SeparatorInternal	Возвращает знак точки, который можно использовать в строке каталога. При переопределении в производном классе может быть возвращен другой знак. (Унаследовано от IsolatedStorage)
UsedSize	Получает значение, показывающее объем пространства, используемого для изолированного хранилища.

Методы

Close()	Закрывает хранилище, открытое ранее с помощью метода GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly() или GetUserStoreForDomain().
CopyFile(String, String)	Копирует существующий файл в новый файл.
CopyFile(String, String, Boolean)	Копирует существующий файл в новый файл и, возможно, перезаписывает существующий файл.
CreateDirectory(String)	Создает в области ограниченного действия изолированного хранения папку.
CreateFile(String)	Создает файл в изолированном хранилище.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
DeleteDirectory(String)	Удаляет из области ограниченного действия изолированного хранилища папку.
DeleteFile(String)	Удаляет из области ограниченного действия изолированного хранилища файл.
DirectoryExists(String)	Определяет, указывает ли заданный путь на существующий каталог в изолированном хранилище.
Dispose()	Освобождает все ресурсы, занятые модулем IsolatedStorageFile.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FileExists(String)	Определяет, указывает ли заданный путь на существующий файл в изолированном хранилище.
GetCreationTime(String)	Возвращает дату и время создания заданного файла или каталога.
GetDirectoryNames()	Перечисляет каталоги в корневой папке изолированного хранилища.
GetDirectoryNames(String)	Перечисляет каталоги в области изолированного хранилища, соответствующие заданному шаблону поиска.
GetEnumerator(IsolatedStorageScope)	Возвращает счетчик для хранилищ IsolatedStorageFile в области ограниченного действия изолированного хранения.
GetFileNames()	Перечисляет имена файлов в корневой папке изолированного хранилища.
GetFileNames(String)	Получает имена файлов, соответствующие шаблону поиска.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLastAccessTime(String)	Возвращает дату и время последнего обращения к указанному файлу или каталогу.
GetLastWriteTime(String)	Возвращает дату и время последней операции записи в указанный файл или каталог.
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetMachineStoreForApplication()	Получает изолированное хранение с областью действия компьютера, соответствующее вызову удостоверения приложения кода.
GetMachineStoreForAssembly()	Получает изолированное хранение с областью действия компьютера, соответствующее вызову удостоверения сборки кода.
GetMachineStoreForDomain()	Возвращает изолированное хранение с областью действия компьютера, соответствующее удостоверению домена приложения и сборки.
GetPermission(PermissionSet)	При реализации с помощью производного класса возвращает разрешение, представляющее доступ к изолированному хранению в наборе разрешений. (Унаследовано от IsolatedStorage)
GetStore(IsolatedStorageScope, Object)	Получает изолированное хранение, соответствующее данному удостоверению приложения.
GetStore(IsolatedStorageScope, Object, Object)	Возвращает изолированное хранение, соответствующее объектам данного домена приложения и свидетельства сборки.
GetStore(IsolatedStorageScope, Type)	Получает изолированное хранение, соответствующее области изоляции и объекту удостоверения приложения.
GetStore(IsolatedStorageScope, Type, Type)	Получает изолированное хранение, соответствующее области ограниченного действия изолированного хранения, предоставляющей типы домена приложения и свидетельства сборки.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetUserStoreForApplication()	Получает изолированное хранение с областью действия пользователя, соответствующее вызову удостоверения приложения кода.
GetUserStoreForAssembly()	Получает изолированное хранение с областью действия пользователя, соответствующее вызову удостоверения сборки кода.
GetUserStoreForDomain()	Получает изолированную область хранения с областью действия пользователя, соответствующую удостоверению домена приложения и удостоверению сборки.
GetUserStoreForSite()	Получает изолированное хранилище с определенной пользователем областью действия для использования приложениями в домене виртуального узла.
IncreaseQuotaTo(Int64)	Позволяет приложению в явной форме запросить больший размер квоты в байтах.
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
InitStore(IsolatedStorageScope, Type)	Инициализирует новый объект IsolatedStorage. (Унаследовано от IsolatedStorage)
InitStore(IsolatedStorageScope, Type, Type)	Инициализирует новый объект IsolatedStorage. (Унаследовано от IsolatedStorage)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
MoveDirectory(String, String)	Перемещает указанный каталог и его содержимое в новое расположение.
MoveFile(String, String)	Перемещает указанный файл в новое расположение и позволяет указать для файла новое имя.
OpenFile(String, FileMode)	Открывает файл в заданном режиме.
OpenFile(String, FileMode, FileAccess)	Открывает файл в заданном режиме с заданным доступом для чтения и записи.
OpenFile(String, FileMode, FileAccess, FileShare)	Открывает файл в заданном режиме, с заданным уровнем доступа для чтения и записи и с разрешением на совместный доступ.
Remove()	Удаляет область ограниченного действия изолированного хранения со всем ее содержимым.
Remove(IsolatedStorageScope)	Удаляет для всех удостоверений указанную область ограниченного действия изолированного хранения.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Изолированное хранилище