IsolatedStorageFile Classe

Definição

Namespace:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Origem:

IsolatedStorageFile.cs

Representa uma área de armazenamento isolado que contém arquivos e diretórios.

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

Herança

Object

MarshalByRefObject

IsolatedStorage

IsolatedStorageFile

Implementações

IDisposable

Exemplos

O exemplo de código a seguir ilustra como criar arquivos e diretórios em um repositório isolado. Primeiro, um repositório isolado por usuário, domínio e assembly é recuperado e colocado na isoStore variável. Em CreateDirectory seguida, o método é chamado para criar diretórios e duas instâncias da IsolatedStorageFileStream classe criar arquivos nesses diretórios.

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

Comentários

Esse objeto corresponde a um escopo de armazenamento isolado específico, em que os arquivos representados por IsolatedStorageFileStream objetos existem. Os aplicativos podem usar o armazenamento isolado para salvar dados em sua própria parte isolada do sistema de arquivos, sem precisar especificar um caminho específico dentro do sistema de arquivos. Como os repositórios isolados têm escopo para assemblies específicos, a maioria dos outros códigos gerenciados não poderá acessar os dados do código (ferramentas de administração e código gerenciado altamente confiáveis podem acessar repositórios de outros assemblies). O código não gerenciado pode acessar quaisquer repositórios isolados.

Para obter mais informações, consulte Armazenamento Isolado.

Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Importante

O armazenamento isolado não está disponível para aplicativos da Store do Windows 8.x. Em vez disso, use as classes de dados de aplicativos nos namespaces Windows.Storage incluídos na API do Windows Runtime para armazenar dados e arquivos locais. Para saber mais, confira Dados de aplicativo no Centro de Desenvolvimento do Windows.

Propriedades

ApplicationIdentity	Obtém uma identidade de aplicativo que define o escopo de armazenamento isolado. (Herdado de IsolatedStorage)
AssemblyIdentity	Obtém a identidade do assembly usada para definir o escopo de armazenamento isolado. (Herdado de IsolatedStorage)
AvailableFreeSpace	Obtém um valor que representa a quantidade de espaço livre disponível para o armazenamento isolado.
CurrentSize	Obsoleto. Obtém o tamanho atual do armazenamento isolado.
DomainIdentity	Obtém uma identidade de domínio que define o escopo desse armazenamento isolado. (Herdado de IsolatedStorage)
IsEnabled	Obtém um valor que indica se o armazenamento isolado está habilitado.
MaximumSize	Obsoleto. Obtém um valor que representa a quantidade máxima de espaço disponível para o armazenamento isolado dentro dos limites estabelecidos pela cota.
Quota	Obtém um valor que representa a quantidade máxima de espaço disponível para armazenamento isolado.
Scope	Obtém um valor de enumeração IsolatedStorageScope especificando o escopo usado para isolar o repositório. (Herdado de IsolatedStorage)
SeparatorExternal	Obtém um caractere de barra invertida que pode ser usado em uma cadeia de caracteres de diretório. Quando substituído em uma classe derivada, outro caractere pode ser retornado. (Herdado de IsolatedStorage)
SeparatorInternal	Obtém um caractere de ponto que pode ser usado em uma cadeia de caracteres de diretório. Quando substituído em uma classe derivada, outro caractere pode ser retornado. (Herdado de IsolatedStorage)
UsedSize	Obtém um valor que representa a quantidade de espaço usada para o armazenamento isolado.

Métodos

Close()	Fecha um repositório aberto anteriormente com GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly() ou GetUserStoreForDomain().
CopyFile(String, String)	Copia um arquivo existente para um novo arquivo.
CopyFile(String, String, Boolean)	Copia um arquivo existente para um novo arquivo e, opcionalmente, substitui um arquivo existente.
CreateDirectory(String)	Cria um diretório no escopo do armazenamento isolado.
CreateFile(String)	Cria um arquivo no repositório isolado.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
DeleteDirectory(String)	Exclui um diretório no escopo do armazenamento isolado.
DeleteFile(String)	Exclui um arquivo no escopo de armazenamento isolado.
DirectoryExists(String)	Determina se o caminho especificado refere-se a um diretório existente no repositório isolado.
Dispose()	Libera todos os recursos usados pelo IsolatedStorageFile.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FileExists(String)	Determina se o caminho especificado refere-se a um arquivo existente no repositório isolado.
GetCreationTime(String)	Retorna a data de criação e a hora de um arquivo ou diretório especificado.
GetDirectoryNames()	Enumera os diretórios na raiz de um repositório isolado.
GetDirectoryNames(String)	Enumera os diretórios em um escopo de armazenamento isolado que correspondam a um padrão de pesquisa fornecido.
GetEnumerator(IsolatedStorageScope)	Obtém o enumerador para os armazenamentos IsolatedStorageFile em um escopo de armazenamento isolado.
GetFileNames()	Enumera os nomes de arquivo na raiz de um repositório isolado.
GetFileNames(String)	Obtém os nomes dos arquivos que correspondem a um padrão de pesquisa.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLastAccessTime(String)	Retorna a data e hora em que um arquivo ou diretório especificado foi acessado pela última vez.
GetLastWriteTime(String)	Retorna a data e hora em um arquivo ou diretório especificado foi gravado pela última vez.
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetMachineStoreForApplication()	Obtém o armazenamento isolado com escopo do computador correspondente à identidade do aplicativo do código de chamada.
GetMachineStoreForAssembly()	Obtém um armazenamento isolado no escopo do computador correspondente à identidade do assembly do código de chamada.
GetMachineStoreForDomain()	Obtém o armazenamento isolado no escopo do computador correspondente à identidade de domínio de aplicativo e à identidade do assembly.
GetPermission(PermissionSet)	Quando implementado por uma classe derivada, retorna uma permissão que representa o acesso ao armazenamento isolado de dentro de um conjunto de permissões. (Herdado de IsolatedStorage)
GetStore(IsolatedStorageScope, Object)	Obtém o armazenamento isolado que corresponde à identidade de determinado aplicativo.
GetStore(IsolatedStorageScope, Object, Object)	Obtém o armazenamento isolado correspondente aos objetos de evidência de assembly e o domínio de aplicativo determinado.
GetStore(IsolatedStorageScope, Type)	Obtém o armazenamento isolado correspondente ao escopo de isolamento e ao objeto de identidade do aplicativo.
GetStore(IsolatedStorageScope, Type, Type)	Obtém o armazenamento isolado correspondente ao escopo do armazenamento isolado considerando o domínio do aplicativo e os tipos de evidência de assembly.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUserStoreForApplication()	Obtém o armazenamento isolado com escopo de usuário correspondente à identidade do aplicativo do código de chamada.
GetUserStoreForAssembly()	Obtém um armazenamento isolado no escopo do usuário correspondente à identidade do assembly do código de chamada.
GetUserStoreForDomain()	Obtém o armazenamento isolado no escopo do usuário correspondente à identidade do domínio do aplicativo e à identidade do assembly.
GetUserStoreForSite()	Obtém um repositório isolado no escopo do usuário para uso por aplicativos em um domínio do host virtual.
IncreaseQuotaTo(Int64)	Permite que um aplicativo solicite explicitamente uma cota maior, em bytes.
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
InitStore(IsolatedStorageScope, Type)	Inicializa um novo objeto IsolatedStorage. (Herdado de IsolatedStorage)
InitStore(IsolatedStorageScope, Type, Type)	Inicializa um novo objeto IsolatedStorage. (Herdado de IsolatedStorage)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MoveDirectory(String, String)	Move um diretório especificado e seu conteúdo para um novo local.
MoveFile(String, String)	Move um arquivo especificado para um novo local e, opcionalmente, permite que você especifique um novo nome de arquivo.
OpenFile(String, FileMode)	Abre um arquivo no modo especificado.
OpenFile(String, FileMode, FileAccess)	Abre um arquivo no modo especificado com o acesso de leitura/gravação especificado.
OpenFile(String, FileMode, FileAccess, FileShare)	Abre um arquivo no modo especificado, com o acesso de leitura/gravação e a permissão de compartilhamento especificados.
Remove()	Remove o escopo do armazenamento isolado e todo seu conteúdo.
Remove(IsolatedStorageScope)	Remove o escopo de armazenamento isolado especificado para todas as identidades.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Armazenamentos isolado