Windows.Storage Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
|
| IStorageFile2 |
Stellt eine Datei dar. Stellt Informationen über die Datei und deren Inhalte sowie Möglichkeiten zum Bearbeiten bereit.
|
| IStorageFilePropertiesWithAvailability |
Bietet Zugriff auf die IsAvailable-Eigenschaft . |
| IStorageFolder |
Bearbeitet Ordner und deren Inhalte und stellt Informationen zu ihnen bereit.
|
| 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.
|
| IStorageItem2 |
Bearbeitet Speicherelemente (Dateien und Ordner) und deren Inhalt und stellt Informationen zu ihnen bereit.
|
| 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
- Dateizugriffsbeispiel (Windows 10)
- Beispiel für ordneraufzählung (Windows 10)
- Einfaches Imageerstellungsbeispiel (Windows 10)
- Beispiel für die Dateiauswahl (Windows 10)
- Beispiel für die Dateisuche (Windows 10)
- Beispiel für Datei- und Ordnerminiaturansicht (Windows 10)
- Bibliotheksverwaltungsbeispiel (Windows 10)
- Beispiel für die Hintergrundübertragung
- Beispiel für die Hintergrundübertragung (Windows 8.x)
- Beispiel für inhaltsindexer
- Serialisieren und Deserialisieren von Datenbeispielen
- Beispiel für Heimnetzgruppe
- End-to-End-Beispiel für RSS-Reader (JavaScript)