Поделиться через


IsolatedStorageFile Класс

Определение

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

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
Наследование
Атрибуты
Реализации

Примеры

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

Получает значение, показывающее объем свободного пространства, доступного для изолированного хранилища.

AvailableFreeSpace

При переопределении в производном классе получает доступное свободное пространство для изолированного хранилища в байтах.

(Унаследовано от IsolatedStorage)
CurrentSize
Устаревшие..
Устаревшие..

Получает текущий размер изолированного хранения.

DomainIdentity

Возвращает удостоверение домена, которое ограничивает область действия изолированного хранения.

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

Получает значение, указывающее, включено ли изолированное хранилище.

MaximumSize
Устаревшие..
Устаревшие..

Возвращает значение, представляющее максимальный размер области, доступной для изолированного хранения в пределах, установленных квотой.

Quota

Получает значение, представляющее максимальный объем свободного пространства, доступного для изолированной памяти.

Quota

При переопределении в производном классе получает значение, представляющее максимальный объем пространства, доступного для изолированной памяти.

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

Получает значение перечисления IsolatedStorageScope, ограничивающее область, используемую для изоляции хранилища.

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

Возвращает знак обратной косой черты, который можно использовать в строке каталога. При переопределении в производном классе может быть возвращен другой знак.

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

Возвращает знак точки, который можно использовать в строке каталога. При переопределении в производном классе может быть возвращен другой знак.

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

Получает значение, показывающее объем пространства, используемого для изолированного хранилища.

UsedSize

При переопределении в производном классе получает значение, показывающее объем пространства, используемого под изолированное хранилище.

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

Методы

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)

Определяет, указывает ли заданный путь на существующий файл в изолированном хранилище.

Finalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.

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, Evidence, Type, Evidence, Type)

Возвращает изолированное хранение, соответствующее объектам и типам данного домена приложения и свидетельства сборки.

GetStore(IsolatedStorageScope, Object)

Получает изолированное хранение, соответствующее данному удостоверению приложения.

GetStore(IsolatedStorageScope, Object, Object)

Возвращает изолированное хранение, соответствующее объектам данного домена приложения и свидетельства сборки.

GetStore(IsolatedStorageScope, Type)

Получает изолированное хранение, соответствующее области изоляции и объекту удостоверения приложения.

GetStore(IsolatedStorageScope, Type, Type)

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

GetType()

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

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

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

GetUserStoreForAssembly()

Получает изолированное хранение с областью действия пользователя, соответствующее вызову удостоверения сборки кода.

GetUserStoreForDomain()

Получает изолированную область хранения с областью действия пользователя, соответствующую удостоверению домена приложения и удостоверению сборки.

GetUserStoreForSite()

Получает изолированное хранилище с определенной пользователем областью действия для использования приложениями в домене виртуального узла.

IncreaseQuotaTo(Int64)

Позволяет приложению в явной форме запросить больший размер квоты в байтах.

IncreaseQuotaTo(Int64)

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

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

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

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