Delen via

Bestanden, mappen en bibliotheken beheren met Windows App SDK

Windows App SDK biedt krachtige mogelijkheden voor bestandsbeheer voor verpakte apps. U kunt API's uit de Windows.Storage, Windows.Storage.Streams en Microsoft.Windows.Storage.Pickers naamruimten gebruiken om efficiënt verschillende gegevensindelingen in bestanden te lezen en te schrijven, en bestanden en mappen te beheren.

Er zijn allerlei API's die betrekking hebben op bestanden, mappen, bibliotheken en instellingen voor Windows-bureaublad-apps die beginnen in Windows 10. Deze functies zijn beschikbaar via een combinatie van Windows App SDK, Windows Runtime (WinRT) en .NET API's van de Windows App SDK, Windows SDK en .NET SDK.

Windows App SDK kiezers gebruiken om gegevens te lezen en te schrijven

Er zijn kiezer-API's beschikbaar in de Windows App SDK versie 1.8 en hoger. De volgende onderwerpen bevatten informatie over het gebruik van de kiezer-API's waarmee gebruikers bestanden en mappen in uw app kunnen openen en opslaan:

Onderwerp Description
Bestanden en mappen openen met kiezers in WinUI Gebruik Windows App SDK bestands- en mapkiezers om gebruikers te laten bladeren door bestanden of mappen in uw WinUI-app en deze te selecteren. De kiezer-API's bieden een vertrouwde Windows-ervaring waarmee gebruikers door hun apparaat en cloud storage locaties kunnen navigeren. Lees hoe u gebruikers een bestand of map kunt laten openen met behulp van de klassen FileOpenPicker en FolderPicker.
Een bestand opslaan met Windows App SDK kiezer in WinUI Bij het bouwen van WinUI-apps en andere Windows-client-apps moeten gebruikers vaak bestanden zoals documenten, afbeeldingen of andere inhoud opslaan op specifieke locaties op hun apparaat. De Windows App SDK biedt de klasse FileSavePicker om een consistente, gebruiksvriendelijke interface te maken waarmee gebruikers kunnen kiezen waar ze bestanden moeten opslaan en wat ze een naam moeten geven.

Belangrijkste verschillen tussen WinRT en Windows App SDK selectoren

Hier volgen enkele belangrijke verschillen bij de WinRT-Windows.Storage.Pickers gebruikt door UWP-apps:

  • In tegenstelling tot de bestaande Windows. Storage. Pickers-API die StorageFile en StorageFolder objecten retourneert, deze nieuwe API retourneert paden op basis van tekenreeksen via PickFileResult en PickFolderResult klassen. Dit vereenvoudigt de API en voorkomt complicaties met storage mogelijkheden in scenario's met verhoogde bevoegdheden.
  • Op dezelfde manier is de eigenschap FileSavePicker.SuggestedSaveFile (die een StorageFile) heeft geretourneerd, vervangen. De functionaliteit wordt nu gedekt door twee tekenreekseigenschappen: SuggestedFolder en SuggestedFileName. Hiermee kunt u de map en bestandsnaam voor het dialoogvenster Opslaan voorstellen.
  • Alle nieuwe kiezers zijn speciaal ontworpen voor bureaublad-apps en gebruiken een WindowId-eigenschap om de kiezer te koppelen aan het hostvenster, waarbij het WinRT.Interop.InitializeWithWindow.Initialize patroon wordt vervangen.
  • Met de nieuwe kiezers kunnen ontwikkelaars ze gebruiken zonder dat hiervoor FileTypeFilter of FileTypeChoices moet worden opgegeven. Hoewel UWP-kiezers uitzonderingen genereren wanneer deze eigenschappen niet zijn ingesteld, worden in de nieuwe kiezers standaard alle bestanden weergegeven wanneer ontwikkelaars deze eigenschappen niet expliciet configureren.
  • De locatie HomeGroup is uitgesloten van de nieuwe PickerLocationId omdat deze niet meer wordt ondersteund vanaf Windows 10.
  • FolderPicker.FileTypeFilter is uitgesloten omdat deze niet functioneel geschikt was voor mapselectie.
  • Methoden en eigenschappen uitsluiten die al zijn gemarkeerd als afgeschaft of 'Niet gebruiken'. bijvoorbeeld PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync, enzovoort.
  • Methoden en eigenschappen uitsluiten voor de modus voor meerdere gebruikers, omdat de nieuwe API's momenteel zijn ontworpen voor bureaubladscenario's waarbij elke gebruiker een eigen interactieve sessie heeft en elke sessie volledig onafhankelijk is van de andere sessies op het apparaat. Dit is in tegenstelling tot Xbox- of andere apparaten met meerdere gebruikers.

Toegang tot gegevens met WinRT storage-API's

Verpakte apps hebben access voor alle WinRT storage-API's die beschikbaar zijn voor UWP-apps. Of u nu een bestaande UWP-app migreert of een nieuwe app maakt, u kunt deze API's gebruiken om gegevens te lezen en te schrijven. Zie Access bestanden en mappen met Windows App SDK en WinRT-API's voor voorbeelden van het gebruik van de storage API's in een WinUI 3-app.

API's voor .NET-bestanden gebruiken voor gegevens toegang

Naast de WinRT-API's kunnen verpakte bureaublad-apps de .NET API's in de System.IO naamruimte gebruiken om gegevens te lezen en schrijven. Wanneer een nieuwe WinUI-project wordt gemaakt, bevat het bestand Package.appxmanifest de volgende instelling:

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

Het declareren van deze beperkte mogelijkheid biedt volledige access aan het bestandssysteem, het register en andere beperkte mogelijkheden. Zie Declaraties van beperkte mogelijkheden voor meer informatie. Met andere woorden, de app heeft dezelfde access voor het bestandssysteem als andere .NET desktop-app bij het gebruik van de .NET bestands-API's.

Zie voor voorbeelden van het gebruik van de .NET API's in een WinUI-app Access bestanden en mappen met Windows App SDK en .NET API's.

Aanvullende bronnen voor het werken met bestanden en mappen

Als u verpakte WinUI-apps ontwikkelt, kunnen de WinRT-storage-API's een krachtig hulpprogramma zijn voor het lezen en schrijven van gegevens. De volgende UWP-onderwerpen bieden een schat aan informatie voor ontwikkelaars die deze API's in hun apps willen gebruiken.

Onderwerp Description
Bestanden en mappen opsommen en er query's op uitvoeren Verkrijg toegang tot bestanden en mappen in een map, bibliotheek, apparaat of netwerklocatie. U kunt ook query's uitvoeren op de bestanden en mappen op een locatie door bestands- en mapquery's samen te stellen.
Een bestand maken, schrijven en lezen Een bestand lezen en schrijven met behulp van een StorageFile-object.
Aanbevolen procedures voor het schrijven naar bestanden Lees de aanbevolen procedures voor het gebruik van verschillende methoden voor het schrijven van bestanden van de klassen FileIO en PathIO.
Bestandseigenschappen ophalen Eigenschappen ophalen(op het hoogste niveau, basis en uitgebreid) voor een bestand dat wordt vertegenwoordigd door een StorageFile-object.
Toegang tot de inhoud van de HomeGroup Access inhoud die is opgeslagen in de map HomeGroup van de gebruiker, inclusief afbeeldingen, muziek en video's.
Bepalen van de beschikbaarheid van Microsoft OneDrive-bestanden Bepaal of een Microsoft OneDrive bestand beschikbaar is met behulp van de eigenschap StorageFile.IsAvailable.
Bestanden en mappen in de bibliotheken Muziek, Afbeeldingen en Video's Voeg bestaande mappen met muziek, afbeeldingen of video's toe aan de bijbehorende bibliotheken. U kunt ook mappen verwijderen uit bibliotheken, de lijst met mappen in een bibliotheek ophalen en opgeslagen foto's, muziek en video's ontdekken.
Recent gebruikte bestanden en mappen bijhouden Houd bestanden bij die uw gebruiker regelmatig opent door ze toe te voegen aan de meest recent gebruikte lijst (MRU) van uw app. Het platform beheert de MRU voor u door items te sorteren op basis van wanneer ze voor het laatst zijn geopend en door het oudste item te verwijderen wanneer de limiet van 25 items van de lijst is bereikt. Alle apps hebben hun eigen MRU.
Wijzigingen in het bestandssysteem op de achtergrond bijhouden Houd wijzigingen in het bestandssysteem bij, zelfs wanneer de app niet wordt uitgevoerd.
Toegang krijgen tot de SD-kaart U kunt niet-essentiële gegevens opslaan en toegang krijgen tot een optionele microSD-kaart, met name op goedkope mobiele apparaten met beperkte interne opslagruimte.
Snelle toegang tot bestandseigenschappen Verzamel efficiënt een lijst met bestanden en hun eigenschappen uit een bibliotheek om te gebruiken via de Windows Runtime API's.

Zie ook

Toegang krijgen tot bestanden en mappen met Windows App SDK en WinRT-API's

Toegang krijgen tot bestanden en mappen met Windows App SDK en .NET API's

System.IO

  • Last updated on