IsolatedStorageFile Klasse

Definition

Namespace:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Quelle:

IsolatedStorageFile.cs

Stellt einen Bereich des isolierten Speicherbereichs dar, der Dateien und Verzeichnisse enthält.

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

Vererbung

Object

MarshalByRefObject

IsolatedStorage

IsolatedStorageFile

Implementiert

IDisposable

Beispiele

Das folgende Codebeispiel zeigt das Erstellen von Dateien und Verzeichnissen in einem isolierten Speicher. Zunächst wird ein Speicher abgerufen, der nach Benutzer, Domäne und Assembly isoliert ist, und in der isoStore Variablen platziert. Die CreateDirectory -Methode wird dann aufgerufen, um Verzeichnisse zu erstellen, und zwei Instanzen der IsolatedStorageFileStream -Klasse erstellen Dateien in diesen Verzeichnissen.

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

Hinweise

Dieses Objekt entspricht einem bestimmten isolierten Speicherbereich, in dem durch Objekte dargestellte IsolatedStorageFileStream Dateien vorhanden sind. Anwendungen können isolierten Speicher verwenden, um Daten in ihrem eigenen isolierten Teil des Dateisystems zu speichern, ohne einen bestimmten Pfad innerhalb des Dateisystems angeben zu müssen. Da isolierte Speicher auf bestimmte Assemblys beschränkt sind, können die meisten anderen verwalteten Code nicht auf die Daten Ihres Codes zugreifen (hoch vertrauenswürdiger verwalteter Code und Verwaltungstools können auf Speicher aus anderen Assemblys zugreifen). Nicht verwalteter Code kann auf alle isolierten Speicher zugreifen.

Weitere Informationen finden Sie unter Isolierte Speicherung.

Dieser Typ implementiert die IDisposable-Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.

Wichtig

Die isolierte Speicherung ist nicht für Windows 8.x Store-Apps verfügbar. Verwenden Sie stattdessen zum Speichern von lokalen Daten und Dateien die in der Windows-Runtime-API enthaltenen Anwendungsdatenklassen in den Windows.Storage-Namespaces. Weitere Informationen finden Sie im Windows Developer Center unter Anwendungsdaten .

Eigenschaften

ApplicationIdentity	Ruft eine Anwendungsidentität ab, die den Gültigkeitsbereich des isolierten Speichers festlegt. (Geerbt von IsolatedStorage)
AssemblyIdentity	Ruft eine Assemblyidentität ab, über die der Gültigkeitsbereich der isolierten Speicherung festgelegt wird. (Geerbt von IsolatedStorage)
AvailableFreeSpace	Ruft einen Wert ab, der den verfügbaren freien Speicherplatz für den isolierten Speicher darstellt.
CurrentSize	Veraltet. Ruft die aktuelle Größe des isolierten Speichers ab.
DomainIdentity	Ruft eine Domänenidentität ab, die den Gültigkeitsbereich des isolierten Speichers festlegt. (Geerbt von IsolatedStorage)
IsEnabled	Ruft einen Wert ab, der angibt, ob der isolierte Speicher aktiviert ist.
MaximumSize	Veraltet. Ruft einen Wert ab, der die maximal verfügbare Größe für den isolierten Speicher in den vom Kontingent festgelegten Grenzen darstellt.
Quota	Ruft einen Wert ab, der den maximal verfügbaren Speicherplatz für den isolierten Speicher darstellt.
Scope	Ruft einen IsolatedStorageScope-Enumerationswert ab, der den zum Isolieren des Speichers verwendeten Gültigkeitsbereich angibt. (Geerbt von IsolatedStorage)
SeparatorExternal	Ruft einen umgekehrten Schrägstrich ab, der in einer Verzeichniszeichenfolge verwendet werden kann. Beim Überschreiben in einer abgeleiteten Klasse kann ein anderes Zeichen zurückgegeben werden. (Geerbt von IsolatedStorage)
SeparatorInternal	Ruft einen Punkt ab, der in einer Verzeichniszeichenfolge verwendet werden kann. Beim Überschreiben in einer abgeleiteten Klasse kann ein anderes Zeichen zurückgegeben werden. (Geerbt von IsolatedStorage)
UsedSize	Ruft einen Wert ab, der den verwendeten Speicherplatz für den isolierten Speicher darstellt.

Methoden

Close()	Schließt einen Speicher, der zuvor mit GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly() oder GetUserStoreForDomain() geöffnet wurde.
CopyFile(String, String)	Kopiert eine vorhandene Datei in eine neue Datei.
CopyFile(String, String, Boolean)	Kopiert eine vorhandene Datei in eine neue Datei. Optional wird eine vorhandene Datei überschrieben.
CreateDirectory(String)	Erstellt ein Verzeichnis im Gültigkeitsbereich des isolierten Speichers.
CreateFile(String)	Erstellt eine Datei im isolierten Speicher.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
DeleteDirectory(String)	Löscht ein Verzeichnis im Gültigkeitsbereich des isolierten Speichers.
DeleteFile(String)	Löscht eine Datei im Gültigkeitsbereich des isolierten Speichers.
DirectoryExists(String)	Bestimmt, ob der angegebene Pfad auf ein vorhandenes Verzeichnis im isolierten Speicher verweist.
Dispose()	Gibt alle vom IsolatedStorageFile verwendeten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FileExists(String)	Bestimmt, ob der angegebene Pfad auf eine vorhandene Datei im isolierten Speicher verweist.
GetCreationTime(String)	Gibt das Erstellungsdatum und den Erstellungszeitpunkt der angegebenen Datei bzw. des angegebenen Verzeichnisses zurück.
GetDirectoryNames()	Listet die Verzeichnisse am Stamm eines isolierten Speichers auf.
GetDirectoryNames(String)	Listet die Verzeichnisse im Gültigkeitsbereich eines isolierten Speichers auf, die mit dem angegebenen Suchmuster übereinstimmen.
GetEnumerator(IsolatedStorageScope)	Ruft den Enumerator für die IsolatedStorageFile-Speicher im Gültigkeitsbereich eines isolierten Speichers ab.
GetFileNames()	Listet die Dateinamen am Stamm eines isolierten Speichers auf.
GetFileNames(String)	Ruft die Dateinamen ab, die einem Suchmuster entsprechen.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLastAccessTime(String)	Gibt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.
GetLastWriteTime(String)	Gibt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis zurück.
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetMachineStoreForApplication()	Ruft computerbezogenen isolierten Speicher für die Identität der Anwendung des aufrufenden Codes ab.
GetMachineStoreForAssembly()	Ruft computerbezogenen isolierten Speicher für die Identität der Assembly des aufrufenden Codes ab.
GetMachineStoreForDomain()	Ruft computerbezogenen isolierten Speicher für die Anwendungsdomänen- und Assemblyidentität ab.
GetPermission(PermissionSet)	Gibt beim Implementieren durch eine abgeleitete Klasse eine Berechtigung aus einem Berechtigungssatz zurück, die den Zugriff auf den isolierten Speicher darstellt. (Geerbt von IsolatedStorage)
GetStore(IsolatedStorageScope, Object)	Ruft den isolierten Speicher ab, der der angegebenen Anwendungsidentität entspricht.
GetStore(IsolatedStorageScope, Object, Object)	Ruft den isolierten Speicher ab, der der angegebenen Anwendungsdomäne und den Assemblybeweisobjekten zugeordnet ist.
GetStore(IsolatedStorageScope, Type)	Ruft isolierten Speicher ab, der dem Isolationsbereich und dem Anwendungsidentitätsobjekt entspricht.
GetStore(IsolatedStorageScope, Type, Type)	Ruft den isolierten Speicher entsprechend dem Gültigkeitsbereich des isolierten Speichers ab, wenn der Typ des Beweises der Anwendungsdomäne und der Assembly angegeben wird.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetUserStoreForApplication()	Ruft benutzerbezogenen isolierten Speicher für die Identität der Anwendung des aufrufenden Codes ab.
GetUserStoreForAssembly()	Ruft benutzerbezogenen isolierten Speicher für die Identität der Assembly des aufrufenden Codes ab.
GetUserStoreForDomain()	Ruft benutzerbezogenen isolierten Speicher für die Anwendungsdomänen- und Assemblyidentität ab.
GetUserStoreForSite()	Ruft einen isolierten Speicher mit benutzerbezogenem Gültigkeitsbereich für die Verwendung durch Anwendungen in einer virtuellen Hostdomäne ab.
IncreaseQuotaTo(Int64)	Ermöglicht es einer Anwendung, explizit eine größere Kontingentgröße in Bytes anzufordern.
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
InitStore(IsolatedStorageScope, Type)	Initialisiert ein neues IsolatedStorage-Objekt. (Geerbt von IsolatedStorage)
InitStore(IsolatedStorageScope, Type, Type)	Initialisiert ein neues IsolatedStorage-Objekt. (Geerbt von IsolatedStorage)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
MoveDirectory(String, String)	Verschiebt das angegebene Verzeichnis und dessen Inhalt an einen neuen Speicherort.
MoveFile(String, String)	Verschiebt eine angegebene Datei an einen neuen Speicherort und ermöglicht das Angeben eines neuen Dateinamens (optional).
OpenFile(String, FileMode)	Öffnet eine Datei im angegebenen Modus.
OpenFile(String, FileMode, FileAccess)	Öffnet eine Datei im angegebenen Modus mit dem angegebenen Lese-/Schreibzugriff.
OpenFile(String, FileMode, FileAccess, FileShare)	Öffnet eine Datei im angegebenen Modus mit dem angegebenen Lese-/Schreibzugriff und der angegebenen Freigabeberechtigung.
Remove()	Entfernt den Gültigkeitsbereich des isolierten Speichers mit dem gesamten Inhalt.
Remove(IsolatedStorageScope)	Entfernt den angegebenen Gültigkeitsbereich des isolierten Speichers für alle Identitäten.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Isolierter Speicher