Verwalten von Dateien, Ordnern und Bibliotheken mit Windows App SDK

Windows App SDK bietet leistungsstarke Dateiverwaltungsfunktionen für verpackte Apps. Sie können APIs aus den Namespaces Windows.Storage, Windows.Storage.Streams und Microsoft.Windows.Storage.Pickers verwenden, um verschiedene Datenformate effizient in Datei(en) zu lesen und zu schreiben sowie Dateien und Ordner zu verwalten.

Es gibt eine Vielzahl von APIs im Zusammenhang mit Dateien, Ordnern, Bibliotheken und Einstellungen für Windows-Desktop-Apps, die mit Windows 10 beginnen. Diese Features stehen über eine Kombination aus Windows App SDK, Windows Runtime (WinRT) und .NET APIs zur Verfügung, die vom Windows App SDK, Windows SDK und .NET SDK bereitgestellt werden.

Verwenden Sie Windows App SDK Picker, um Daten zu lesen und zu schreiben.

In der Windows App SDK Version 1.8 und höher sind Auswahl-APIs verfügbar. Die folgenden Themen enthalten Informationen zur Verwendung der Auswahl-APIs, damit Benutzer Dateien und Ordner in Ihrer App öffnen und speichern können:

Thema	Description
Öffnen von Dateien und Ordnern mit Pickern in WinUI	Verwenden Sie Windows App SDK Datei- und Ordnerauswahl, um Benutzern das Durchsuchen und Auswählen von Dateien oder Ordnern in Ihrer WinUI-App zu ermöglichen. Die Auswahl-APIs bieten ein vertrautes Windows-Erlebnis, mit dem Benutzer auf ihrem Gerät und in Cloud-Speicherorten navigieren können. Erfahren Sie, wie Sie Benutzern die Auswahl einer Datei oder eines Ordners mithilfe der Klassen FileOpenPicker und FolderPicker ermöglichen.
Eine Datei mit dem Windows App SDK-Auswahltool in WinUI speichern	Beim Erstellen von WinUI-Apps und anderen Windows-Client-Apps müssen Benutzer häufig Dateien wie Dokumente, Bilder oder andere Inhalte an bestimmten Speicherorten auf ihrem Gerät speichern. Die Windows App SDK stellt die Klasse FileSavePicker bereit, um eine konsistente, benutzerfreundliche Benutzeroberfläche zu erstellen, über die Benutzer auswählen können, wo Dateien gespeichert werden sollen und was sie nennen sollen.

Wichtige Unterschiede zwischen WinRT und Windows App SDK „Picker“

Hier sind einige wichtige Unterschiede der von UWP-Apps verwendeten WinRT-Komponente Windows.Storage.Pickers:

• Im Gegensatz zu den vorhandenen Windows. Storage. Pickers-API, die StorageFile und StorageFolder Objekte zurückgibt, Diese neue API gibt zeichenfolgenbasierte Pfade über PickFileResult und PickFolderResult Klassen zurück. Dies vereinfacht die API und vermeidet Komplikationen mit Speicherfunktionen in anspruchsvollen Szenarien.
• Ebenso wurde die FileSavePicker.SuggestedSaveFile-Eigenschaft (die eine StorageFile) zurückgegeben hat, ersetzt. Die Funktionalität wird jetzt von zwei Zeichenfolgeneigenschaften abgedeckt: SuggestedFolder und SuggestedFileName. Auf diese Weise können Sie den Ordner und dateinamen für das Dialogfeld "Speichern" vorschlagen.
• Alle neuen Picker wurden speziell für Desktop-Apps entwickelt und verwenden eine WindowId-Eigenschaft, um die Picker mit ihrem Hostfenster zu verknüpfen und das WinRT.Interop.InitializeWithWindow.Initialize Muster zu ersetzen.
• Mit den neuen Auswahlern können Entwickler sie verwenden, ohne FileTypeFilter oder FileTypeChoices anzugeben. Während UWP-Auswahl Ausnahmen auslöst, wenn diese Eigenschaften nicht festgelegt sind, werden in der neuen Auswahl standardmäßig alle Dateien angezeigt, wenn Entwickler diese Eigenschaften nicht explizit konfigurieren.
• Der Speicherort HomeGroup wurde aus der neuen PickerLocationId-Aufzählung ausgeschlossen, da er ab Windows 10 nicht mehr unterstützt wird.
• FolderPicker.FileTypeFilter wurde ausgeschlossen, da sie nicht für die Ordnerauswahl geeignet war.
• Ausschließen von Methoden und Eigenschaften, die bereits als veraltet gekennzeichnet sind oder "Nicht verwenden". z. B. PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync usw.
• Ausschließen von Methoden und Eigenschaften für den Mehrbenutzermodus, da die neuen APIs derzeit für Desktopszenarien konzipiert sind, in denen jeder Benutzer über eine eigene interaktive Sitzung verfügt und jede Sitzung vollständig unabhängig von den anderen Sitzungen auf dem Gerät ist. Dies steht im Gegensatz zu Xbox oder anderen Geräten mit mehreren Benutzern.

Greifen Sie auf Daten mit WinRT-Speicher-APIs zu

Verpackte Apps verfügen über Zugriff auf alle WinRT-Speicher-APIs, die für UWP-Apps zur Verfügung stehen. Unabhängig davon, ob Sie eine vorhandene UWP-App migrieren oder eine neue App erstellen, können Sie diese APIs verwenden, um Daten zu lesen und zu schreiben. Beispiele für die Verwendung der storage-APIs in einer WinUI 3-App finden Sie unter Access Dateien und Ordner mit Windows App SDK- und WinRT-APIs.

Verwenden Sie .NET Datei-APIs für den Datenzugriff

Zusätzlich zu den WinRT-APIs können verpackte Desktop-Apps die .NET-APIs im Namespace System.IO verwenden, um Daten zu lesen und zu schreiben. Wenn ein neues WinUI-Projekt erstellt wird, enthält die Datei Package.appxmanifest die folgende Einstellung:

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

Durch das Deklarieren dieser eingeschränkten Funktionen wird vollständiger Zugriff auf das Dateisystem, die Registrierung und andere eingeschränkte Funktionen bereitgestellt. Weitere Informationen finden Sie unter Eingeschränkte Funktionsdeklarationen. Mit anderen Worten, die App hat denselben Zugriff auf das Dateisystem wie jede andere .NET-Desktop-App bei Verwendung der .NET-Datei-APIs.

Beispiele für die Verwendung der .NET-APIs in einer WinUI-App finden Sie unter Access Dateien und Ordner mit Windows App SDK und .NET APIs.

Zusätzliche Ressourcen zum Arbeiten mit Dateien und Ordnern

Wenn Sie gepackte WinUI-Apps entwickeln, können die WinRT-storage-APIs ein leistungsfähiges Tool zum Lesen und Schreiben von Daten sein. Die folgenden UWP-Themen bieten eine Fülle von Informationen für Entwickler, die diese APIs in ihren Apps nutzen möchten.

Thema	Description
Aufzählen und Abfragen von Dateien und Ordnern	Greifen Sie auf Dateien und Ordner in einem Ordner, einer Bibliothek, einem Gerät oder einem Netzwerkspeicherort zu. Sie können die Dateien und Ordner auch an einem Speicherort abfragen, indem Sie Datei- und Ordnerabfragen erstellen.
Erstellen, Schreiben und Lesen einer Datei	Lesen und Schreiben einer Datei mithilfe eines StorageFile-Objekts.
Bewährte Methoden zum Schreiben in Dateien	Lernen Sie bewährte Methoden für die Verwendung verschiedener Methoden zum Schreiben von Dateien der Klassen FileIO und PathIO kennen.
Abrufen von Dateieigenschaften	Eigenschaften auf Top-Level, Basis- und Erweiterungsebene für eine Datei abrufen, die durch ein StorageFile-Objekt dargestellt wird.
Zugreifen auf Heimnetzgruppeninhalte	Zugriff auf Inhalte, die im Heimnetzgruppe-Ordner des Benutzers gespeichert sind, einschließlich Bilder, Musik und Videos.
Determinierende Verfügbarkeit von Microsoft OneDrive Dateien	Ermitteln Sie, ob eine Microsoft OneDrive Datei mit der Eigenschaft StorageFile.IsAvailable verfügbar ist.
Dateien und Ordner in den Bibliotheken "Musik", "Bilder" und "Videos"	Fügen Sie den entsprechenden Bibliotheken vorhandene Ordner mit Musik, Bildern oder Videos hinzu. Sie können Ordner auch aus Bibliotheken entfernen, die Liste der Ordner in einer Bibliothek abrufen und gespeicherte Fotos, Musik und Videos entdecken.
Nachverfolgen zuletzt verwendeter Dateien und Ordner	Verfolgen Sie Dateien, auf die Ihr Benutzer häufig zugreift, indem Sie sie der Liste der zuletzt verwendeten Dateien Ihrer App (MRU) hinzufügen. Die Plattform verwaltet die MRU für Sie, indem Sie Elemente basierend auf dem Zeitpunkt des letzten Zugriffs sortieren und das älteste Element entfernen, wenn der Grenzwert für 25 Elemente der Liste erreicht ist. Alle Apps verfügen über eigene MRU.
Nachverfolgen von Dateisystemänderungen im Hintergrund	Nachverfolgen von Änderungen am Dateisystem, auch wenn die App nicht ausgeführt wird.
Zugriff auf die SD-Karte	Sie können unwichtige Daten auf einer optionalen microSD-Karte speichern und darauf zugreifen, insbesondere bei kostengünstigen mobilen Geräten mit eingeschränktem internem Speicher.
Schneller Zugriff auf Dateieigenschaften	Sammeln Sie effizient eine Liste von Dateien und deren Eigenschaften aus einer Bibliothek, die über die Windows Runtime-APIs verwendet werden sollen.

Siehe auch

Zugriff auf Dateien und Ordner mithilfe der Windows App SDK- und WinRT-APIs

Zugriff auf Dateien und Ordner mit Windows App SDK und .NET APIs

System.IO