Windows.Storage Namespace

Stellt Klassen zum Verwalten von Dateien, Ordnern und Anwendungseinstellungen bereit.

Informationen zur Verwendung der Objekte im Windows. Den Speichernamespace finden Sie in den folgenden Abschnitten.

Klassen

Name Beschreibung
AppDataPaths

AppDataPaths gibt Pfade zu häufig verwendeten Anwendungsordnern basierend auf dem Namensmuster KNOWNFOLDERID zurück.

ApplicationData

Bietet Zugriff auf den Anwendungsdatenspeicher. Anwendungsdaten bestehen aus Dateien und Einstellungen, die entweder lokal, roaming oder temporär sind.

ApplicationDataCompositeValue

Stellt verwandte App-Einstellungen dar, die atomisch serialisiert und deserialisiert werden müssen.

ApplicationDataContainer

Stellt einen Container für App-Einstellungen dar. Die Methoden und Eigenschaften dieser Klasse unterstützen das Erstellen, Löschen, Aufzählen und Durchlaufen der Containerhierarchie.

ApplicationDataContainerSettings

Bietet Zugriff auf die Einstellungen in einem Einstellungscontainer. Die ApplicationDataContainer.Values-Eigenschaft gibt ein Objekt zurück, das in diesen Typ umwandeln kann.

CachedFileManager

Ermöglicht Apps das Verwalten von Echtzeitupdates für Dateien.

DownloadsFolder

Erstellt Dateien und Ordner im Ordner "Downloads".

FileIO

Stellt Hilfsmethoden zum Lesen und Schreiben von Dateien bereit, die durch Objekte vom Typ IStorageFile dargestellt werden.

KnownFolders

Bietet Zugriff auf allgemeine Speicherorte, die Benutzerinhalte enthalten. Dazu gehören Inhalte aus den lokalen Bibliotheken eines Benutzers (z. B. Dokumente, Bilder, Musik und Videos), Heimnetzgruppe, Wechselmedien und Medienservergeräte.

PathIO

Stellt Hilfsmethoden zum Lesen und Schreiben einer Datei mithilfe des absoluten Pfads oder des URI (Uniform Resource Identifier) der Datei bereit.

SetVersionDeferral

Verwaltet einen verzögerten Satzversionsvorgang.

SetVersionRequest

Stellt Daten bereit, wenn eine App die Version der Anwendungsdaten im App-Datenspeicher festlegt.

StorageFile

Stellt eine Datei dar. Stellt Informationen über die Datei und deren Inhalt sowie Möglichkeiten zum Bearbeiten bereit.

StorageFolder

Verwaltet Ordner und deren Inhalte und stellt Informationen zu ihnen bereit.

StorageLibrary

Hiermit können Sie Ordner aus einer Bibliothek wie Musik oder Videos hinzufügen und entfernen und eine Liste der Ordner abrufen, die in der Bibliothek enthalten sind.

StorageLibraryChange

Stellt eine Änderung an einem Element in einer Speicherbibliothek dar, z. B. Dokumente, Musik oder Videobibliothek.

StorageLibraryChangeReader

Ermöglicht der aufrufenden App das Lesen der Änderungen an Elementen in einer Speicherbibliothek.

StorageLibraryChangeTracker

Stellt APIs bereit, die Sie zum Verwalten der Änderungsnachverfolgung für jede Bibliothek (z. B. Dokumente, Musik oder Videos) oder Ordner verwenden können.

StorageLibraryChangeTrackerOptions

Ermöglicht Es Anrufern, EnableWithOptions auf der Änderungsverfolgung aufzurufen, um auszuwählen, ob alle Änderungen einschließlich der letzten Änderungs-ID oder nur die letzte Änderungs-ID nachverfolgt werden sollen.

StorageLibraryLastChangeId

Ermöglicht es Ihnen, Änderungen basierend auf einem eindeutigen Wert nachzuverfolgen, der die letzte Änderung darstellt, die vom Indizierungsdienst für den angegebenen StorageFolder oder StorageLibrary verarbeitet wurde.

StorageProvider

Enthält Informationen zum Dienst, der Dateien und Ordner speichert. Dateien und Ordner können entweder vom lokalen Dateisystem oder von einem Remotedienst wie Microsoft OneDrive gespeichert werden.

StorageStreamTransaction

Stellt eine Schreibtransaktion für einen Datenstrom mit wahlfreiem Zugriff dar.

StreamedFileDataRequest

Stellt einen Datenstrom mit sequenziellem Zugriff dar, der eine Anforderung für den Datenstrom einer StorageFile angibt, die durch Aufrufen von CreateStreamedFileAsync oder ReplaceWithStreamedFileAsync erstellt wurde.

SystemAudioProperties

Ein Hilfsobjekt, das Indizierungsnamen für Windows Audiodateieigenschaften bereitstellt.

SystemDataPaths

Ruft einige häufig verwendete systemweite Ordnerspeicherorte basierend auf dem Benennungsmuster KNOWNFOLDERID ab.

SystemGPSProperties

Ein Hilfsobjekt, das Indizierungsnamen für GPS-Dateieigenschaften bereitstellt.

SystemImageProperties

Ein Hilfsobjekt, das Indizierungsnamen für Windows Bilddateieigenschaften bereitstellt.

SystemMediaProperties

Ein Hilfsobjekt, das Indizierungsnamen für Windows Mediendateieigenschaften bereitstellt.

SystemMusicProperties

Ein Hilfsobjekt, das Indizierungsnamen für Windows Musikdateieigenschaften bereitstellt.

SystemPhotoProperties

Ein Hilfsobjekt, das Indizierungsnamen für Windows Eigenschaften von Fotodateien bereitstellt.

SystemProperties

Stellt Zeichenfolgenwerte für die Indizierung von Namen allgemeiner Windows Dateieigenschaften wie System.Title bereit und verweist auch auf Hilfsobjekte, die Indizierungsnamen für Eigenschaften bestimmter Dateitypen (z. B. Videodateien) bereitstellen.

SystemVideoProperties

Ein Hilfsobjekt, das Indizierungsnamen für Videodateieigenschaften bereitstellt.

UserDataPaths

Gibt vollständige Pfade für allgemeine Benutzerdatenordner zurück. Benutzerdatenordner basieren auf dem Benennungsmuster KNOWNFOLDERID .

Schnittstellen

Name Beschreibung
IStorageFile

Stellt eine Datei dar. Stellt Informationen über die Datei und deren Inhalte sowie Möglichkeiten zum Bearbeiten bereit.

Important

Wenn Sie einfach mit Dateien in Ihrer App arbeiten möchten, lesen Sie die StorageFile-Klasse .

IStorageFile2

Stellt eine Datei dar. Stellt Informationen über die Datei und deren Inhalte sowie Möglichkeiten zum Bearbeiten bereit.

Important

Wenn Sie einfach mit Dateien in Ihrer App arbeiten möchten, lesen Sie die StorageFile-Klasse .

IStorageFilePropertiesWithAvailability

Bietet Zugriff auf die IsAvailable-Eigenschaft .

IStorageFolder

Bearbeitet Ordner und deren Inhalte und stellt Informationen zu ihnen bereit.

Important

Wenn Sie einfach mit Ordnern in Ihrer App arbeiten möchten, lesen Sie die StorageFolder-Klasse .

IStorageFolder2

Bearbeitet Ordner und deren Inhalte und stellt Informationen zu ihnen bereit.

Important

Wenn Sie einfach mit Ordnern in Ihrer App arbeiten möchten, lesen Sie die StorageFolder-Klasse .

IStorageItem

Bearbeitet Speicherelemente (Dateien und Ordner) und deren Inhalt und stellt Informationen zu ihnen bereit.

Important

Wenn Sie einfach mit Dateien und Ordnern in Ihrer App arbeiten möchten, lesen Sie die Klassen StorageFile und StorageFolder .

IStorageItem2

Bearbeitet Speicherelemente (Dateien und Ordner) und deren Inhalt und stellt Informationen zu ihnen bereit.

Important

Wenn Sie einfach mit Dateien und Ordnern in Ihrer App arbeiten möchten, lesen Sie die Klassen StorageFile und StorageFolder .

IStorageItemProperties

Bietet Zugriff auf allgemeine und Inhaltseigenschaften für Elemente (z. B. Dateien und Ordner).

IStorageItemProperties2

Bietet Zugriff auf Methoden, die ein skaliertes Bild als Miniaturansicht abrufen.

IStorageItemPropertiesWithProvider

Bietet Zugriff auf allgemeine und Inhaltseigenschaften für Speicherelemente von einem bestimmten Anbieter.

IStreamedFileDataRequest

Stellt einen Datenstrom mit sequenziellem Zugriff dar, der eine Anforderung für den Datenstrom einer StorageFile angibt, die durch Aufrufen von CreateStreamedFileAsync oder ReplaceWithStreamedFileAsync erstellt wurde.

Enumerationen

Name Beschreibung
ApplicationDataCreateDisposition

Gibt Optionen zum Erstellen von Anwendungsdatencontainern oder zum Zurückgeben vorhandener Container an. Diese Aufzählung wird von der ApplicationDataContainer.CreateContainer-Methode verwendet.

ApplicationDataLocality

Gibt den Typ eines Anwendungsdatenspeichers an.

CreationCollisionOption

Gibt an, was zu tun ist, wenn eine Datei oder ein Ordner mit dem angegebenen Namen bereits im aktuellen Ordner vorhanden ist, wenn Sie eine neue Datei oder einen neuen Ordner erstellen.

FileAccessMode

Gibt an, ob im schreibgeschützten Modus oder im Lese-/Schreibmodus auf eine Datei zugegriffen werden soll.

FileAttributes

Beschreibt die Attribute einer Datei oder eines Ordners.

KnownFolderId

Stellt Werte bereit, die Speicherordner identifizieren.

KnownFoldersAccessStatus

Beschreibt den Zugriff eines bekannten Ordners auf eine einzelne Funktion.

KnownLibraryId

Stellt Werte bereit, die Speicherbibliotheken identifizieren.

NameCollisionOption

Gibt an, was zu tun ist, wenn eine Datei oder ein Ordner mit dem angegebenen Namen bereits im aktuellen Ordner vorhanden ist, wenn Sie eine Datei oder einen Ordner kopieren, verschieben oder umbenennen.

StorageDeleteOption

Gibt an, ob ein gelöschtes Element in den Papierkorb verschoben oder endgültig gelöscht wird.

StorageItemTypes

Beschreibt, ob ein Element, das die IStorageItem-Schnittstelle implementiert, eine Datei oder ein Ordner ist.

StorageLibraryChangeType

Beschreibt den Typ der Änderung, die für das Speicherbibliothekselement aufgetreten ist.

StorageOpenOptions

Stellt Optionen bereit, die beim Öffnen einer Datei verwendet werden sollen.

StreamedFileFailureMode

Gibt den Grund an, warum Daten nicht gestreamt werden konnten.

Delegaten

Name Beschreibung
ApplicationDataSetVersionHandler

Stellt eine Methode dar, die die Anforderung verarbeitet, um die Version der Anwendungsdaten im Anwendungsdatenspeicher festzulegen.

StreamedFileDataRequestedHandler

Stellt die Methode dar, die Daten in eine StorageFile streamt, wenn zuerst auf diese Datei zugegriffen wird.

Hinweise

Hinweis

App-Framework-Kompatibilität: Die Windows. Speicher-APIs sind für Windows App SDK (WinUI 3)-Desktop-Apps und Win32-Desktop-Apps verfügbar, nicht nur UWP-Apps. Desktop-Apps können Klassen wie StorageFile, StorageFolder und ApplicationData über C#/WinRT oder C++/WinRT verwenden. Einige APIs (z. B. die Dateiauswahl) erfordern zusätzliche Konfiguration in entpackten Desktop-Apps. Ausführliche Informationen finden Sie unter Aufrufen von Windows-Runtime-APIs in Desktop-Apps.

Siehe auch