IsolatedStorageFile Classe

Definição

Espaço de Nomes:
System.IO.IsolatedStorage
Assemblagens:
mscorlib.dll, System.IO.IsolatedStorage.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Representa uma área de armazenamento isolada que contém ficheiros e diretórios.

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
Herança
Object
IsolatedStorageFile
Herança
Object
MarshalByRefObject
IsolatedStorage
IsolatedStorageFile
Atributos
ComVisibleAttribute
Implementações
IDisposable

Exemplos

O seguinte exemplo de código ilustra como criar ficheiros e diretórios num armazenamento isolado. Primeiro, um armazenamento isolado por utilizador, domínio e assembly é recuperado e colocado na isoStore variável. O CreateDirectory método é então chamado para criar diretórios, e duas instâncias da IsolatedStorageFileStream classe criam ficheiros 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

Observações

Este objeto corresponde a um escopo de armazenamento isolado específico, onde existem ficheiros representados por IsolatedStorageFileStream objetos. As aplicações podem usar armazenamento isolado para guardar dados na sua própria parte isolada do sistema de ficheiros, sem necessidade de especificar um caminho específico dentro do sistema de ficheiros. Como os armazenamentos isolados são direcionados para assemblies específicos, a maioria dos outros códigos geridos não conseguirá aceder aos dados do seu código (o código gerido e ferramentas de administração altamente confiáveis podem aceder a armazenamentos a partir de outros assemblies). Código não gerido pode aceder a quaisquer armazenamentos isolados.

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

Este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deve eliminá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco try/catch. Para descartá-lo indiretamente, use uma construção de linguagem como using (em C#) ou Using (em Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" no tópico da IDisposable interface.

Importante

O armazenamento isolado não está disponível para aplicações da Loja Windows 8.x. Em vez disso, use as classes de dados do aplicativo nos Windows.Storage namespaces incluídos na API do Tempo de Execução do Windows para armazenar dados e arquivos locais. Para obter mais informações, consulte Dados de aplicativos no Centro de Desenvolvimento do Windows.

Propriedades

Name Description
ApplicationIdentity

Obtém uma identidade de aplicação que abrange o armazenamento isolado.

(Herdado de IsolatedStorage)
AssemblyIdentity

Obtém uma identidade assembly usada para definir o alcance do armazenamento isolado.

(Herdado de IsolatedStorage)
AvailableFreeSpace

Obtém um valor que representa a quantidade de espaço livre disponível para armazenamento isolado.
CurrentSize
Obsoleto.

Obtém o tamanho atual do armazenamento isolado.
DomainIdentity

Obtém uma identidade de domínio que abrange o alcance do armazenamento isolado.

(Herdado de IsolatedStorage)
IsEnabled

Recebe um valor que indica se o armazenamento isolado está ativado.
MaximumSize
Obsoleto.

Recebe um valor que representa a quantidade máxima de espaço disponível para armazenamento isolado dentro dos limites estabelecidos pela quota.
Quota

Obtém um valor que representa a quantidade máxima de espaço disponível para armazenamento isolado.
Scope

Recebe um IsolatedStorageScope valor de enumeração que especifica o âmbito usado para isolar o armazenamento.

(Herdado de IsolatedStorage)
SeparatorExternal

Obtém um carácter de barra inversa que pode ser usado numa cadeia de diretórios. Quando é sobreposto numa classe derivada, outro carácter pode ser devolvido.

(Herdado de IsolatedStorage)
SeparatorInternal

Obtém um carácter ponto que pode ser usado numa cadeia de diretórios. Quando é sobreposto numa classe derivada, outro carácter pode ser devolvido.

(Herdado de IsolatedStorage)
UsedSize

Obtém um valor que representa a quantidade do espaço usado para armazenamento isolado.

Métodos

Name Description
Close()

Fecha uma loja anteriormente aberta com GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly(), ou GetUserStoreForDomain().
CopyFile(String, String, Boolean)

Copia um ficheiro existente para um novo ficheiro e, opcionalmente, sobrescreve um ficheiro existente.
CopyFile(String, String)

Copia um ficheiro existente para um novo ficheiro.
CreateDirectory(String)

Cria um diretório no escopo de armazenamento isolado.
CreateFile(String)

Cria um ficheiro na loja isolada.
CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
DeleteDirectory(String)

Elimina um diretório no âmbito de armazenamento isolado.
DeleteFile(String)

Apaga um ficheiro no escopo de armazenamento isolado.
DirectoryExists(String)

Determina se o caminho especificado se refere a um diretório existente no armazenamento isolado.
Dispose()

Liberta todos os recursos utilizados pelo IsolatedStorageFile.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FileExists(String)

Determina se o caminho especificado se refere a um ficheiro existente no armazenamento isolado.
Finalize()

Permite que um objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo.
GetCreationTime(String)

Devolve a data e hora de criação de um ficheiro ou diretório especificado.
GetDirectoryNames()

Enumera os diretórios na raiz de um armazenamento isolado.
GetDirectoryNames(String)

Enumera os diretórios num âmbito de armazenamento isolado que correspondem a um determinado padrão de pesquisa.
GetEnumerator(IsolatedStorageScope)

Obtém o enumerador para os IsolatedStorageFile armazenamentos dentro de um âmbito de armazenamento isolado.
GetFileNames()

Enumera os nomes dos ficheiros na raiz de um armazenamento isolado.
GetFileNames(String)

Obtém os nomes dos ficheiros que correspondem a um padrão de pesquisa.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLastAccessTime(String)

Devolve a data e hora em que um ficheiro ou diretório especificado foi acedido pela última vez.
GetLastWriteTime(String)

Devolve a data e hora em que um ficheiro ou diretório especificado foi escrito pela última vez.
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetMachineStoreForApplication()

Obtém armazenamento isolado com alcance de máquina correspondente à identidade da aplicação do código chamador.
GetMachineStoreForAssembly()

Obtém armazenamento isolado com alcance de máquina correspondente à identidade assembly do código chamado.
GetMachineStoreForDomain()

Obtém armazenamento isolado com alcance de máquina correspondente à identidade do domínio da aplicação e à identidade de assembly.
GetPermission(PermissionSet)

Quando implementado por uma classe derivada, devolve uma permissão que representa o acesso a armazenamento isolado dentro de um conjunto de permissões.

(Herdado de IsolatedStorage)
GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type)

Obtém armazenamento isolado correspondente ao domínio de aplicação dado e aos objetos e tipos de evidência em assembly.
GetStore(IsolatedStorageScope, Object, Object)

Obtém o armazenamento isolado correspondente ao domínio de aplicação dado e aos objetos de evidência em assembly.
GetStore(IsolatedStorageScope, Object)

Obtém armazenamento isolado correspondente à identidade da aplicação dada.
GetStore(IsolatedStorageScope, Type, Type)

Obtém armazenamento isolado correspondente ao âmbito de armazenamento isolado dado o domínio de aplicação e os tipos de evidência em assembly.
GetStore(IsolatedStorageScope, Type)

Obtém armazenamento isolado correspondente ao âmbito de isolamento e ao objeto identidade da aplicação.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUserStoreForApplication()

Obtém armazenamento isolado, com alcance do utilizador, correspondente à identidade da aplicação do código que chama.
GetUserStoreForAssembly()

Obtém armazenamento isolado com âmbito de utilizador correspondente à identidade assembly do código que chama.
GetUserStoreForDomain()

Obtém armazenamento isolado com âmbito de utilizador correspondente à identidade do domínio da aplicação e à identidade de assembly.
GetUserStoreForSite()

Obtém um armazenamento isolado com âmbito de utilizador para uso por aplicações num domínio anfitrião virtual.
IncreaseQuotaTo(Int64)

Permite que uma aplicação solicite explicitamente um tamanho de quota maior, em bytes.
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
InitStore(IsolatedStorageScope, Type, Type)

Inicializa um novo IsolatedStorage objeto.

(Herdado de IsolatedStorage)
InitStore(IsolatedStorageScope, Type)

Inicializa um novo IsolatedStorage objeto.

(Herdado de IsolatedStorage)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
MoveDirectory(String, String)

Move um diretório especificado e o seu conteúdo para uma nova localização.
MoveFile(String, String)

Move um ficheiro especificado para uma nova localização e, opcionalmente, permite-te especificar um novo nome de ficheiro.
OpenFile(String, FileMode, FileAccess, FileShare)

Abre um ficheiro no modo especificado, com a permissão de acesso e partilha de leitura/escrita especificada.
OpenFile(String, FileMode, FileAccess)

Abre um ficheiro no modo especificado com o acesso de leitura/escrita especificado.
OpenFile(String, FileMode)

Abre um ficheiro no modo especificado.
Remove()

Remove o âmbito de armazenamento isolado e todo o seu conteúdo.
Remove(IsolatedStorageScope)

Remove o escopo de armazenamento isolado especificado para todas as identidades.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também