Dateien, Ordner und Bibliotheken mit Windows App SDK

Verpackte Windows App SDK-Apps können die leistungsstarken APIs nutzen, die von den Namespaces Windows.Storage, Windows.Storage.Streams und Windows.Storage.Pickers bereitgestellt werden, um verschiedene Datenformate in Dateien effizient zu lesen und zu schreiben sowie Dateien und Ordner zu verwalten. In diesem Abschnitt werden wichtige Themen behandelt, z. B. Lesen und Schreiben von App-Einstellungen, Datei- und Ordnerauswahl sowie der Zugriff auf spezielle Sandbox-Standorte wie die Video-/Musikbibliothek. Erfahren Sie, wie Sie die Dateiverwaltungsfunktionen Ihrer App mit dem Windows App SDK optimieren.

Windows 10 und höhere Betriebssystemversionen bieten eine Vielzahl von APIs im Zusammenhang mit Dateien, Ordnern, Bibliotheken und Einstellungen für Apps. Diese Features sind über eine Kombination aus WinRT- und .NET-APIs verfügbar, die vom Windows SDK und dem .NET SDK bereitgestellt werden.

Lesen und Schreiben von Daten mit WinRT-Speicher-APIs

Verpackte Apps haben Zugriff auf alle WinRT-Speicher-APIs, die für UWP-Apps verfügbar sind. Unabhängig davon, ob Sie eine vorhandene UWP-App migrieren oder eine neue App erstellen, können Sie diese APIs zum Lesen und Schreiben von Daten verwenden. Beispiele für die Verwendung der Speicher-APIs in einer WinUI-App finden Sie unter Zugreifen auf Dateien und Ordner mit Windows App SDK- und WinRT-APIs.

Lesen und Schreiben von Daten mit .NET-Datei-APIs

Zusätzlich zu den WinRT-APIs können verpackte Apps die .NET-APIs im System.IO-Namespace zum Lesen und Schreiben von Daten verwenden. Wenn ein neues WinUI 3-Projekt erstellt wird, enthält seine Package.appxmanifest-Datei die folgende Einstellung:

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

Das Deklarieren dieser eingeschränkten Funktion ermöglicht den vollständigen Zugriff auf das Dateisystem, die Registrierung und andere eingeschränkte Funktionen. Weitere Informationen finden Sie unter Deklarationen der eingeschränkten Funktionen. Anders ausgedrückt: Die App hat den gleichen Zugriff auf das Dateisystem wie jede andere .NET-Desktop-App, wenn sie die .NET-Datei-APIs verwendet.

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

Zusätzliche Ressourcen für die Arbeit mit Dateien und Ordnern

Wenn Sie verpackte WinUI-Apps entwickeln, können die WinRT-Speicher-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	BESCHREIBUNG
Aufzählen und Abfragen von Dateien und Ordnern	Greifen Sie auf Dateien und Ordner zu, die sich in einem Ordner, in einer Bibliothek, auf einem Gerät oder an einer Netzwerkadresse befinden. Sie können auch durch Erstellen von Datei- und Ordnerabfragen Dateien und Ordner an bestimmten Speicherorten abrufen.
Erstellen, Schreiben und Lesen einer Datei	Lesen und Schreiben Sie eine Datei mithilfe eines StorageFile-Objekts.
Bewährte Methoden zum Schreiben in Dateien	Hier finden Sie bewährte Methoden für verschiedene Dateischreibvorgänge mit den Klassen FileIO und PathIO.
Abrufen von Dateieigenschaften	Es werden Eigenschaften – oberste Ebene, grundlegend und erweitert – für eine Datei abgerufen, die durch ein StorageFile-Objekt dargestellt wird.
Öffnen von Dateien und Ordnern mit einer Auswahl	Greifen Sie auf Dateien und Ordner zu, indem Sie Benutzern die Interaktion mit einer Auswahl ermöglichen. Sie können über FolderPicker auf einen Ordner zugreifen. HINWEIS: In einer Desktop-App (einschließlich WinUI 3-Apps) können Sie Datei- und Ordnerauswahlfunktionen von Windows.Storage.Pickers verwenden. Wenn die Desktop-App jedoch eine erhöhte Ausführung erfordert, benötigen Sie einen anderen Ansatz, da diese APIs nicht für die Verwendung in einer erhöhten App konzipiert sind. Ein Beispiel finden Sie unter FileSavePicker.
Speichern einer Datei mit einer Auswahl	Mithilfe von FileSavePicker können Benutzer den Namen und Speicherort zum Speichern einer Datei durch die App angeben.
Zugriff auf Inhalte in der Heimnetzgruppe	Greifen Sie auf Inhalte zu, die sich im Heimnetzgruppenordner des Benutzers befinden, einschließlich Bildern, Musik und Videos.
Ermitteln der Verfügbarkeit von Microsoft OneDrive-Dateien	Ermitteln Sie mithilfe der StorageFile.IsAvailable-Eigenschaft, ob eine Microsoft OneDrive-Datei verfügbar ist.
Dateien und Ordner in den Musik-, Bild- und Videobibliotheken	Fügen Sie vorhandene Musik-, Bilder- oder Video-Ordner den entsprechenden Bibliotheken hinzu. Sie können auch Ordner aus Bibliotheken entfernen, die Liste der Ordner in einer Bibliothek abrufen und gespeicherte Fotos, Musik und Videos untersuchen.
Nachverfolgen kürzlich verwendeter Dateien und Ordner	Sie können Dateien nachverfolgen, auf die häufig zugegriffen wird, indem Sie sie der Liste mit den zuletzt verwendeten Elementen (MRU) der App hinzufügen. Die Plattform verwaltet die MRU für Sie. Dabei werden Elemente nach der Zeit und dem Ort des letzten Zugriffs sortiert und die ältesten Elemente entfernt, wenn das Limit von 25 Elementen erreicht ist. Alle Apps besitzen eine eigene MRU.
Nachverfolgen von Dateisystemänderungen im Hintergrund	Verfolgen Sie Änderungen am Dateisystem nach, selbst wenn die App nicht ausgeführt wird.
Zugreifen auf die SD-Karte	Sie können weniger wichtige Daten auf einer optionalen microSD-Karte speichern und auf diese zugreifen. Dies gilt besonders für kostengünstige Geräte, die nur über einen begrenzten internen Speicher verfügen.
Schneller Zugriff auf Dateieigenschaften	Stellen Sie schnell eine Liste von Dateien und ihren Eigenschaften über eine Bibliothek zur Verwendung über Windows Runtime-APIs zusammen.

Siehe auch

Zugreifen auf Dateien und Ordner mit Windows App SDK und WinRT-APIs

Zugreifen auf Dateien und Ordner mit Windows App SDK und .NET-APIs

System.IO