IsolatedStorageFile Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje izolovanou oblast úložiště obsahující soubory a adresáře.
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
- Dědičnost
-
IsolatedStorageFile
- Dědičnost
- Atributy
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak vytvořit soubory a adresáře v izolovaném úložišti. Nejprve se načte úložiště, které je izolované uživatelem, doménou a sestavením, a umístí se do isoStore
proměnné . Metoda CreateDirectory je pak volána k vytvoření adresářů a dvě instance IsolatedStorageFileStream třídy vytvářejí soubory v těchto adresářích.
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
Poznámky
Tento objekt odpovídá konkrétnímu oboru izolovaného úložiště, kde existují soubory reprezentované IsolatedStorageFileStream objekty. Aplikace můžou pomocí izolovaného úložiště ukládat data ve své vlastní izolované části systému souborů, aniž by musely zadávat konkrétní cestu v systému souborů. Vzhledem k tomu, že izolovaná úložiště jsou vymezena na konkrétní sestavení, většina ostatních spravovaných kódů nebude mít přístup k datům vašeho kódu (vysoce důvěryhodný spravovaný kód a nástroje pro správu mohou přistupovat k úložištím z jiných sestavení). Nespravovaný kód má přístup ke všem izolovaným úložištím.
Další informace najdete v tématu Izolované úložiště.
Tento typ implementuje IDisposable rozhraní . Až s použitím typu skončíte, měli byste ho odstranit přímo nebo nepřímo. Chcete-li odstranit typ přímo, zavolejte jeho Dispose metodu try
/catch
v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, jako using
je (v jazyce C#) nebo Using
(v jazyce Visual Basic). Další informace najdete v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.
Důležité
Izolované úložiště není k dispozici pro aplikace pro Windows 8.x Store. Místo toho k ukládání místních dat a souborů použijte datové třídy aplikací v Windows.Storage
oborech názvů, které jsou součástí rozhraní API prostředí Windows Runtime. Další informace najdete v tématu Data aplikací na webu Windows Dev Center.
Vlastnosti
ApplicationIdentity |
Získá identitu aplikace, která definuje izolované úložiště. (Zděděno od IsolatedStorage) |
AssemblyIdentity |
Získá identitu sestavení sloužící k určení rozsahu izolovaného úložiště. (Zděděno od IsolatedStorage) |
AvailableFreeSpace |
Získá hodnotu, která představuje množství volného místa dostupného pro izolované úložiště. |
AvailableFreeSpace |
Při přepsání v odvozené třídě získá dostupné volné místo pro izolované úložiště v bajtech. (Zděděno od IsolatedStorage) |
CurrentSize |
Zastaralé.
Zastaralé.
Získá aktuální velikost izolovaného úložiště. |
DomainIdentity |
Získá identitu domény, která definuje izolované úložiště. (Zděděno od IsolatedStorage) |
IsEnabled |
Získá hodnotu, která označuje, zda je povoleno izolované úložiště. |
MaximumSize |
Zastaralé.
Zastaralé.
Získá hodnotu představující maximální množství místa dostupného pro izolované úložiště v rámci limitů stanovených kvótou. |
Quota |
Získá hodnotu, která představuje maximální množství místa dostupného pro izolované úložiště. |
Quota |
Při přepsání v odvozené třídě získá hodnotu, která představuje maximální velikost místa dostupného pro izolované úložiště. (Zděděno od IsolatedStorage) |
Scope |
IsolatedStorageScope Získá hodnotu výčtu určující obor použitý k izolaci úložiště. (Zděděno od IsolatedStorage) |
SeparatorExternal |
Získá znak zpětného lomítka, který lze použít v řetězci adresáře. Při přepsání v odvozené třídě může být vrácen jiný znak. (Zděděno od IsolatedStorage) |
SeparatorInternal |
Získá znak tečky, který lze použít v řetězci adresáře. Při přepsání v odvozené třídě může být vrácen jiný znak. (Zděděno od IsolatedStorage) |
UsedSize |
Získá hodnotu, která představuje velikost místa použitého pro izolované úložiště. |
UsedSize |
Při přepsání v odvozené třídě získá hodnotu, která představuje velikost místa použitého pro izolované úložiště. (Zděděno od IsolatedStorage) |
Metody
Close() |
Zavře dříve otevřené úložiště pomocí GetStore(IsolatedStorageScope, Type, Type)příkazu , GetUserStoreForAssembly()nebo GetUserStoreForDomain(). |
CopyFile(String, String) |
Zkopíruje existující soubor do nového souboru. |
CopyFile(String, String, Boolean) |
Zkopíruje existující soubor do nového souboru a volitelně přepíše existující soubor. |
CreateDirectory(String) |
Vytvoří adresář v oboru izolovaného úložiště. |
CreateFile(String) |
Vytvoří soubor v izolovaném úložišti. |
CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
DeleteDirectory(String) |
Odstraní adresář v oboru izolovaného úložiště. |
DeleteFile(String) |
Odstraní soubor v oboru izolovaného úložiště. |
DirectoryExists(String) |
Určuje, zda zadaná cesta odkazuje na existující adresář v izolovaném úložišti. |
Dispose() |
Uvolní všechny prostředky používané nástrojem IsolatedStorageFile. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FileExists(String) |
Určuje, zda zadaná cesta odkazuje na existující soubor v izolovaném úložišti. |
Finalize() |
Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění předtím, než je uvolněna uvolňováním paměti. |
GetCreationTime(String) |
Vrátí datum a čas vytvoření zadaného souboru nebo adresáře. |
GetDirectoryNames() |
Vytvoří výčet adresářů v kořenovém adresáři izolovaného úložiště. |
GetDirectoryNames(String) |
Vytvoří výčet adresářů v oboru izolovaného úložiště, které odpovídají danému vzoru vyhledávání. |
GetEnumerator(IsolatedStorageScope) |
Získá enumerátor pro IsolatedStorageFile úložiště v rozsahu izolovaného úložiště. |
GetFileNames() |
Vytvoří výčet názvů souborů v kořenovém adresáři izolovaného úložiště. |
GetFileNames(String) |
Získá názvy souborů, které odpovídají vzoru hledání. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetLastAccessTime(String) |
Vrátí datum a čas posledního přístupu k zadanému souboru nebo adresáři. |
GetLastWriteTime(String) |
Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře. |
GetLifetimeService() |
Zastaralé.
Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
GetMachineStoreForApplication() |
Získá izolované úložiště v oboru počítače odpovídající identitě aplikace volajícího kódu. |
GetMachineStoreForAssembly() |
Získá izolované úložiště v rozsahu počítače, které odpovídá identitě sestavení volajícího kódu. |
GetMachineStoreForDomain() |
Získá izolované úložiště v oboru počítače odpovídající identitě domény aplikace a identitě sestavení. |
GetPermission(PermissionSet) |
Při implementaci odvozenou třídou vrátí oprávnění, které představuje přístup k izolovanému úložišti v rámci sady oprávnění. (Zděděno od IsolatedStorage) |
GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type) |
Získá izolované úložiště odpovídající dané doméně aplikace a sestavení důkaz objekty a typy. |
GetStore(IsolatedStorageScope, Object) |
Získá izolované úložiště odpovídající dané identitě aplikace. |
GetStore(IsolatedStorageScope, Object, Object) |
Získá izolované úložiště odpovídající dané doméně aplikace a objekty důkazu sestavení. |
GetStore(IsolatedStorageScope, Type) |
Získá izolované úložiště odpovídající oboru izolace a objektu identity aplikace. |
GetStore(IsolatedStorageScope, Type, Type) |
Získá izolované úložiště odpovídající oboru izolovaného úložiště vzhledem k doméně aplikace a sestavení evidence typů. |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
GetUserStoreForApplication() |
Získá izolované úložiště v oboru uživatele, které odpovídá identitě aplikace volajícího kódu. |
GetUserStoreForAssembly() |
Získá izolované úložiště v oboru uživatele odpovídající identitě sestavení volajícího kódu. |
GetUserStoreForDomain() |
Získá izolované úložiště v oboru uživatele odpovídající identitě domény aplikace a identitě sestavení. |
GetUserStoreForSite() |
Získá uživatelem vymezené izolované úložiště pro použití aplikacemi ve virtuální hostitelské doméně. |
IncreaseQuotaTo(Int64) |
Umožňuje aplikaci explicitně požadovat větší kvótu v bajtech. |
IncreaseQuotaTo(Int64) |
Při přepsání v odvozené třídě vyzve uživatele ke schválení větší kvóty v bajtech pro izolované úložiště. (Zděděno od IsolatedStorage) |
InitializeLifetimeService() |
Zastaralé.
Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
InitStore(IsolatedStorageScope, Type) |
Inicializuje nový IsolatedStorage objekt. (Zděděno od IsolatedStorage) |
InitStore(IsolatedStorageScope, Type, Type) |
Inicializuje nový IsolatedStorage objekt. (Zděděno od IsolatedStorage) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
MoveDirectory(String, String) |
Přesune zadaný adresář a jeho obsah do nového umístění. |
MoveFile(String, String) |
Přesune zadaný soubor do nového umístění a volitelně vám umožní zadat nový název souboru. |
OpenFile(String, FileMode) |
Otevře soubor v zadaném režimu. |
OpenFile(String, FileMode, FileAccess) |
Otevře soubor v zadaném režimu se zadaným přístupem pro čtení i zápis. |
OpenFile(String, FileMode, FileAccess, FileShare) |
Otevře soubor v zadaném režimu se zadaným přístupem ke čtení a zápisu a oprávněním ke sdílení. |
Remove() |
Odebere obor izolovaného úložiště a veškerý jeho obsah. |
Remove(IsolatedStorageScope) |
Odebere zadaný obor izolovaného úložiště pro všechny identity. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |