IsolatedStorageFile IsolatedStorageFile IsolatedStorageFile IsolatedStorageFile Class

Definition

Stellt einen Bereich des isolierten Speichers mit Dateien und Verzeichnissen dar.Represents an isolated storage area containing files and directories.

public ref class IsolatedStorageFile sealed : System::IO::IsolatedStorage::IsolatedStorage, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
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
IsolatedStorageFileIsolatedStorageFileIsolatedStorageFileIsolatedStorageFile
Attribute
Implementiert

Beispiele

Das folgende Codebeispiel zeigt das Erstellen von Dateien und Verzeichnissen in einem isolierten Speicher.The following code example illustrates how to create files and directories in an isolated store. Zuerst wird ein Speicher, der nach Benutzer, Domäne und Assembly isoliert ist, abgerufen und in der isoStore Variablen abgelegt.First, a store that is isolated by user, domain, and assembly is retrieved and placed in the isoStore variable. Anschließend CreateDirectory wird die-Methode aufgerufen, um Verzeichnisse zu erstellen, und zwei IsolatedStorageFileStream Instanzen der-Klasse erstellen Dateien in diesen Verzeichnissen.The CreateDirectory method is then called to create directories, and two instances of the IsolatedStorageFileStream class create files in these directories.

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 Dateien vorhanden sind IsolatedStorageFileStream , die durch-Objekte dargestellt werden.This object corresponds to a specific isolated storage scope, where files represented by IsolatedStorageFileStream objects exist. Anwendungen können isolierte Speicherung verwenden, um Daten in einem eigenen isolierten Teil des Dateisystems zu speichern, ohne einen bestimmten Pfad innerhalb des Dateisystems angeben zu müssen.Applications can use isolated storage to save data in their own isolated portion of the file system, without having to specify a particular path within the file system. Da isolierte Speicher auf bestimmte Assemblys beschränkt sind, können die meisten anderen verwalteten Codes nicht auf die Daten Ihres Codes zugreifen (hochgradig vertrauenswürdiger verwalteter Code und Verwaltungs Tools können auf Speicher von anderen Assemblys zugreifen).Since isolated stores are scoped to particular assemblies, most other managed code will not be able to access your code's data (highly trusted managed code and administration tools can access stores from other assemblies). Nicht verwalteter Code kann auf isolierte Speicher zugreifen.Unmanaged code can access any isolated stores.

Weitere Informationen finden Sie unter Isolierte Speicherung.For more information, see Isolated Storage.

Dieser Typ implementiert die IDisposable-Schnittstelle.This type implements the IDisposable interface. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen.When you have finished using the type, you should dispose of it either directly or indirectly. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf.To dispose of the type directly, call its Dispose method in a try/catch block. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Wichtig

Isolierte Speicherung ist nicht für Windows 8.x StoreWindows 8.x Store -Apps verfügbar.Isolated storage is not available for Windows 8.x StoreWindows 8.x Store apps. Verwenden Sie stattdessen die zum Speichern von lokalen Daten und Dateien in der Windows.Storage-API enthaltenen Anwendungsdatenklassen in den Windows-RuntimeWindows Runtime-Namespaces.Instead, use the application data classes in the Windows.Storage namespaces included in the Windows-RuntimeWindows Runtime API to store local data and files. Weitere Informationen finden Sie im Windows Developer Center unter Anwendungsdaten .For more information, see Application data in the Windows Dev Center.

Eigenschaften

AvailableFreeSpace AvailableFreeSpace AvailableFreeSpace AvailableFreeSpace

Ruft einen Wert ab, der den verfügbaren freien Speicherplatz für den isolierten Speicher darstellt.Gets a value that represents the amount of free space available for isolated storage.

CurrentSize CurrentSize CurrentSize CurrentSize

Ruft die aktuelle Größe des isolierten Speichers ab.Gets the current size of the isolated storage.

IsEnabled IsEnabled IsEnabled IsEnabled

Ruft einen Wert ab, der angibt, ob der isolierte Speicher aktiviert ist.Gets a value that indicates whether isolated storage is enabled.

MaximumSize MaximumSize MaximumSize MaximumSize

Ruft einen Wert ab, der die maximal verfügbare Größe für den isolierten Speicher in den vom Kontingent festgelegten Grenzen darstellt.Gets a value representing the maximum amount of space available for isolated storage within the limits established by the quota.

Quota Quota Quota Quota

Ruft einen Wert ab, der den maximal verfügbaren Speicherplatz für den isolierten Speicher darstellt.Gets a value that represents the maximum amount of space available for isolated storage.

UsedSize UsedSize UsedSize UsedSize

Ruft einen Wert ab, der den verwendeten Speicherplatz für den isolierten Speicher darstellt.Gets a value that represents the amount of the space used for isolated storage.

Methoden

Close() Close() Close() Close()

Schließt einen Speicher, der zuvor mit GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly() oder GetUserStoreForDomain() geöffnet wurde.Closes a store previously opened with GetStore(IsolatedStorageScope, Type, Type), GetUserStoreForAssembly(), or GetUserStoreForDomain().

CopyFile(String, String) CopyFile(String, String) CopyFile(String, String) CopyFile(String, String)

Kopiert eine vorhandene Datei in eine neue Datei.Copies an existing file to a new file.

CopyFile(String, String, Boolean) CopyFile(String, String, Boolean) CopyFile(String, String, Boolean) CopyFile(String, String, Boolean)

Kopiert eine vorhandene Datei in eine neue Datei. Optional wird eine vorhandene Datei überschrieben.Copies an existing file to a new file, and optionally overwrites an existing file.

CreateDirectory(String) CreateDirectory(String) CreateDirectory(String) CreateDirectory(String)

Erstellt ein Verzeichnis im Gültigkeitsbereich des isolierten Speichers.Creates a directory in the isolated storage scope.

CreateFile(String) CreateFile(String) CreateFile(String) CreateFile(String)

Erstellt eine Datei im isolierten Speicher.Creates a file in the isolated store.

DeleteDirectory(String) DeleteDirectory(String) DeleteDirectory(String) DeleteDirectory(String)

Löscht ein Verzeichnis im Gültigkeitsbereich des isolierten Speichers.Deletes a directory in the isolated storage scope.

DeleteFile(String) DeleteFile(String) DeleteFile(String) DeleteFile(String)

Löscht eine Datei im Gültigkeitsbereich des isolierten Speichers.Deletes a file in the isolated storage scope.

DirectoryExists(String) DirectoryExists(String) DirectoryExists(String) DirectoryExists(String)

Bestimmt, ob der angegebene Pfad auf ein vorhandenes Verzeichnis im isolierten Speicher verweist.Determines whether the specified path refers to an existing directory in the isolated store.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom IsolatedStorageFile verwendeten Ressourcen frei.Releases all resources used by the IsolatedStorageFile.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FileExists(String) FileExists(String) FileExists(String) FileExists(String)

Bestimmt, ob der angegebene Pfad auf eine vorhandene Datei im isolierten Speicher verweist.Determines whether the specified path refers to an existing file in the isolated store.

Finalize() Finalize() Finalize() Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetCreationTime(String) GetCreationTime(String) GetCreationTime(String) GetCreationTime(String)

Gibt das Erstellungsdatum und den Erstellungszeitpunkt der angegebenen Datei bzw. des angegebenen Verzeichnisses zurück.Returns the creation date and time of a specified file or directory.

GetDirectoryNames() GetDirectoryNames() GetDirectoryNames() GetDirectoryNames()

Listet die Verzeichnisse am Stamm eines isolierten Speichers auf.Enumerates the directories at the root of an isolated store.

GetDirectoryNames(String) GetDirectoryNames(String) GetDirectoryNames(String) GetDirectoryNames(String)

Listet die Verzeichnisse im Gültigkeitsbereich eines isolierten Speichers auf, die mit dem angegebenen Suchmuster übereinstimmen.Enumerates the directories in an isolated storage scope that match a given search pattern.

GetEnumerator(IsolatedStorageScope) GetEnumerator(IsolatedStorageScope) GetEnumerator(IsolatedStorageScope) GetEnumerator(IsolatedStorageScope)

Ruft den Enumerator für die IsolatedStorageFile-Speicher im Gültigkeitsbereich eines isolierten Speichers ab.Gets the enumerator for the IsolatedStorageFile stores within an isolated storage scope.

GetFileNames() GetFileNames() GetFileNames() GetFileNames()

Listet die Dateinamen am Stamm eines isolierten Speichers auf.Enumerates the file names at the root of an isolated store.

GetFileNames(String) GetFileNames(String) GetFileNames(String) GetFileNames(String)

Ruft die Dateinamen ab, die einem Suchmuster entsprechen.Gets the file names that match a search pattern.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLastAccessTime(String) GetLastAccessTime(String) GetLastAccessTime(String) GetLastAccessTime(String)

Gibt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.Returns the date and time a specified file or directory was last accessed.

GetLastWriteTime(String) GetLastWriteTime(String) GetLastWriteTime(String) GetLastWriteTime(String)

Gibt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis zurück.Returns the date and time a specified file or directory was last written to.

GetMachineStoreForApplication() GetMachineStoreForApplication() GetMachineStoreForApplication() GetMachineStoreForApplication()

Ruft computerbezogenen isolierten Speicher für die Identität der Anwendung des aufrufenden Codes ab.Obtains machine-scoped isolated storage corresponding to the calling code's application identity.

GetMachineStoreForAssembly() GetMachineStoreForAssembly() GetMachineStoreForAssembly() GetMachineStoreForAssembly()

Ruft computerbezogenen isolierten Speicher für die Identität der Assembly des aufrufenden Codes ab.Obtains machine-scoped isolated storage corresponding to the calling code's assembly identity.

GetMachineStoreForDomain() GetMachineStoreForDomain() GetMachineStoreForDomain() GetMachineStoreForDomain()

Ruft computerbezogenen isolierten Speicher für die Anwendungsdomänen- und Assemblyidentität ab.Obtains machine-scoped isolated storage corresponding to the application domain identity and the assembly identity.

GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type) GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type) GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type) GetStore(IsolatedStorageScope, Evidence, Type, Evidence, Type)

Ruft den isolierten Speicher ab, der der angegebenen Anwendungsdomäne und den Assemblybeweisobjekten und -typen zugeordnet ist.Obtains isolated storage corresponding to the given application domain and the assembly evidence objects and types.

GetStore(IsolatedStorageScope, Object) GetStore(IsolatedStorageScope, Object) GetStore(IsolatedStorageScope, Object) GetStore(IsolatedStorageScope, Object)

Ruft den isolierten Speicher ab, der der angegebenen Anwendungsidentität entspricht.Obtains isolated storage corresponding to the given application identity.

GetStore(IsolatedStorageScope, Object, Object) GetStore(IsolatedStorageScope, Object, Object) GetStore(IsolatedStorageScope, Object, Object) GetStore(IsolatedStorageScope, Object, Object)

Ruft den isolierten Speicher ab, der der angegebenen Anwendungsdomäne und den Assemblybeweisobjekten zugeordnet ist.Obtains the isolated storage corresponding to the given application domain and assembly evidence objects.

GetStore(IsolatedStorageScope, Type) GetStore(IsolatedStorageScope, Type) GetStore(IsolatedStorageScope, Type) GetStore(IsolatedStorageScope, Type)

Ruft isolierten Speicher ab, der dem Isolationsbereich und dem Anwendungsidentitätsobjekt entspricht.Obtains isolated storage corresponding to the isolation scope and the application identity object.

GetStore(IsolatedStorageScope, Type, Type) GetStore(IsolatedStorageScope, Type, Type) GetStore(IsolatedStorageScope, Type, Type) 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.Obtains isolated storage corresponding to the isolated storage scope given the application domain and assembly evidence types.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetUserStoreForApplication() GetUserStoreForApplication() GetUserStoreForApplication() GetUserStoreForApplication()

Ruft benutzerbezogenen isolierten Speicher für die Identität der Anwendung des aufrufenden Codes ab.Obtains user-scoped isolated storage corresponding to the calling code's application identity.

GetUserStoreForAssembly() GetUserStoreForAssembly() GetUserStoreForAssembly() GetUserStoreForAssembly()

Ruft benutzerbezogenen isolierten Speicher für die Identität der Assembly des aufrufenden Codes ab.Obtains user-scoped isolated storage corresponding to the calling code's assembly identity.

GetUserStoreForDomain() GetUserStoreForDomain() GetUserStoreForDomain() GetUserStoreForDomain()

Ruft benutzerbezogenen isolierten Speicher für die Anwendungsdomänen- und Assemblyidentität ab.Obtains user-scoped isolated storage corresponding to the application domain identity and assembly identity.

GetUserStoreForSite() GetUserStoreForSite() GetUserStoreForSite() GetUserStoreForSite()

Ruft einen isolierten Speicher mit benutzerbezogenem Gültigkeitsbereich für die Verwendung durch Anwendungen in einer virtuellen Hostdomäne ab.Obtains a user-scoped isolated store for use by applications in a virtual host domain.

IncreaseQuotaTo(Int64) IncreaseQuotaTo(Int64) IncreaseQuotaTo(Int64) IncreaseQuotaTo(Int64)

Ermöglicht es einer Anwendung, explizit eine größere Kontingentgröße in Bytes anzufordern.Enables an application to explicitly request a larger quota size, in bytes.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MoveDirectory(String, String) MoveDirectory(String, String) MoveDirectory(String, String) MoveDirectory(String, String)

Verschiebt das angegebene Verzeichnis und dessen Inhalt an einen neuen Speicherort.Moves a specified directory and its contents to a new location.

MoveFile(String, String) MoveFile(String, String) MoveFile(String, String) MoveFile(String, String)

Verschiebt eine angegebene Datei an einen neuen Speicherort und ermöglicht das Angeben eines neuen Dateinamens (optional).Moves a specified file to a new location, and optionally lets you specify a new file name.

OpenFile(String, FileMode) OpenFile(String, FileMode) OpenFile(String, FileMode) OpenFile(String, FileMode)

Öffnet eine Datei im angegebenen Modus.Opens a file in the specified mode.

OpenFile(String, FileMode, FileAccess) OpenFile(String, FileMode, FileAccess) OpenFile(String, FileMode, FileAccess) OpenFile(String, FileMode, FileAccess)

Öffnet eine Datei im angegebenen Modus mit dem angegebenen Lese-/Schreibzugriff.Opens a file in the specified mode with the specified read/write access.

OpenFile(String, FileMode, FileAccess, FileShare) OpenFile(String, FileMode, FileAccess, FileShare) OpenFile(String, FileMode, FileAccess, FileShare) OpenFile(String, FileMode, FileAccess, FileShare)

Öffnet eine Datei im angegebenen Modus mit dem angegebenen Lese-/Schreibzugriff und der angegebenen Freigabeberechtigung.Opens a file in the specified mode, with the specified read/write access and sharing permission.

Remove() Remove() Remove() Remove()

Entfernt den Gültigkeitsbereich des isolierten Speichers mit dem gesamten Inhalt.Removes the isolated storage scope and all its contents.

Remove(IsolatedStorageScope) Remove(IsolatedStorageScope) Remove(IsolatedStorageScope) Remove(IsolatedStorageScope)

Entfernt den angegebenen Gültigkeitsbereich des isolierten Speichers für alle Identitäten.Removes the specified isolated storage scope for all identities.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch