Dela via

Hantera filer, mappar och bibliotek med Windows App SDK

Windows App SDK tillhandahåller kraftfulla filhanteringsfunktioner för paketerade appar. Du kan använda API:er från Windows.Storage, Windows.Storage.Streams och Microsoft.Windows.Storage.Pickers namnområdena för att effektivt läsa och skriva olika dataformat i filer, samt hantera filer och mappar.

Det finns en mängd olika API:er relaterade till filer, mappar, bibliotek och inställningar för Windows-skrivbordsappar från och med Windows 10. Dessa funktioner är tillgängliga via en kombination av Windows App SDK, Windows Runtime (WinRT) och .NET API:er som tillhandahålls av Windows App SDK, Windows SDK och .NET SDK.

Använd Windows App SDK-väljare för att läsa och skriva data

Det finns väljare-API:er tillgängliga i Windows App SDK version 1.8 och senare. Följande ämnen ger information om hur du använder valverktygs-API:er i din app för att låta användare öppna och spara filer och mappar:

Ämne Description
Öppna filer och mappar med valkontroller i WinUI Använd Windows App SDK fil- och mappväljare för att låta användare bläddra bland och välja filer eller mappar i WinUI-appen. Väljarnas API:er ger en välbekant Windows-upplevelse som hjälper användare att navigera bland sina enheter och molnlagringsplatser. Lär dig hur du låter användare välja en fil eller mapp som ska öppnas med hjälp av klasserna FileOpenPicker och FolderPicker.
Spara en fil med Windows App SDK väljare i WinUI När du skapar WinUI-appar och andra Windows-klientappar behöver användarna ofta spara filer som dokument, bilder eller annat innehåll på specifika platser på sin enhet. I Windows App SDK finns klassen FileSavePicker för att skapa ett konsekvent, användarvänligt gränssnitt där användarna kan välja var filer ska sparas och vad de ska namnges.

Viktiga skillnader mellan WinRT- och Windows App SDK-väljare

Här följer några viktiga skillnader från WinRT Windows.Storage.Pickers som används av UWP-appar:

  • Till skillnad från den befintliga Windows. Storage. Väljare API som returnerar StorageFile och StorageFolder objekt, det här nya API:et returnerar strängbaserade sökvägar via PickFileResult och PickFolderResult klasser. Detta förenklar API:et och undviker komplikationer med storage funktioner i förhöjda scenarier.
  • På samma sätt har egenskapen FileSavePicker.SuggestedSaveFile (som returnerade en StorageFile) ersatts. Funktionen omfattas nu av två strängegenskaper: SuggestedFolder och SuggestedFileName. Med dessa kan du föreslå mappen och filnamnet för dialogrutan Spara.
  • Alla nya väljare är särskilt utformade för skrivbordsappar och använder en WindowId-egenskap för att länka väljaren till värdfönstret och ersätta WinRT.Interop.InitializeWithWindow.Initialize mönstret.
  • Med de nya valen kan utvecklare använda dem utan att behöva FileTypeFilter eller FileTypeChoices specificeras. UWP-väljare utlöser undantag när dessa egenskaper inte har angetts, men de nya plockarna visar alla filer när utvecklare inte uttryckligen konfigurerar dessa egenskaper.
  • Platsen HomeGroup har exkluderats från den nya PickerLocationId uppräkning eftersom den inte längre stöds från och med Windows 10.
  • FolderPicker.FileTypeFilter har exkluderats eftersom det inte var funktionellt lämpligt för mappval.
  • Exkludering av metoder och egenskaper som redan har markerats som inaktuella eller "Använd inte". t.ex. PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync osv.
  • Exklusive metoder och egenskaper för läget för flera användare, eftersom de nya API:erna för närvarande är utformade för skrivbordsscenarier där varje användare har en egen interaktiv session, och varje session är helt oberoende av de andra sessionerna på enheten. Detta står i kontrast till Xbox eller andra enheter med flera användare.

Att använda data med WinRT-lagrings-API:erna

Paketerade appar har access till alla WinRT storage API:er som är tillgängliga för UWP-appar. Oavsett om du migrerar en befintlig UWP-app eller skapar en ny app kan du använda dessa API:er för att läsa och skriva data. Exempel på hur du använder storage API:er i en WinUI 3-app finns i Access filer och mappar med Windows App SDK och WinRT-API:er.

Använd .NET-fil-API:er för dataåtkomst

Förutom WinRT-API:er kan paketerade skrivbordsappar använda .NET API:er i namnområdet System.IO för att läsa och skriva data. När en ny WinUI-project skapas innehåller filen Package.appxmanifest följande inställning:

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

Att deklarera den här begränsade funktionen ger fullständig access till filsystemet, registret och andra begränsade funktioner. Mer information finns i Begränsade kapacitetsdeklarationer. Med andra ord har appen samma access till filsystemet som andra .NET skrivbordsapp när du använder .NET fil-API:er.

Exempel på hur du använder .NET API:er i en WinUI-app finns i Access filer och mappar med Windows App SDK och .NET API:er.

Ytterligare resurser för att arbeta med filer och mappar

Om du utvecklar paketerade WinUI-appar kan WinRT-storage API:er vara ett kraftfullt verktyg för att läsa och skriva data. Följande UWP-ämnen innehåller en mängd information för utvecklare som vill utnyttja dessa API:er i sina appar.

Ämne Description
Räkna upp och fråga filer och mappar Åtkomst till filer och mappar antingen i en mapp, ett bibliotek, på en enhet eller i en nätverksplats. Du kan också köra frågor mot filer och mappar på en plats genom att skapa fil- och mappfrågor.
Skapa, skriva och läsa en fil Läsa och skriva en fil med hjälp av ett StorageFile-objekt.
Metodtips för att skriva till filer Lär dig metodtips för att använda olika metoder för filskrivning i klasserna FileIO och PathIO.
Hämta filegenskaper Hämta egenskaper – toppnivå, grundläggande och utökad – för en fil som representeras av ett StorageFile-objekt.
Åtkomst till Innehåll i hemgrupp Access innehåll som lagras i användarens hemgruppsmapp, inklusive bilder, musik och videor.
Bestämmande tillgänglighet för Microsoft OneDrive filer Kontrollera om en Microsoft OneDrive fil är tillgänglig med egenskapen StorageFile.IsAvailable.
Filer och mappar i biblioteken Musik, Bilder och Videor Lägg till befintliga mappar med musik, bilder eller videor i motsvarande bibliotek. Du kan också ta bort mappar från bibliotek, hämta listan över mappar i ett bibliotek och identifiera lagrade foton, musik och videor.
Spåra nyligen använda filer och mappar Spåra filer som användaren kommer åt ofta genom att lägga till dem i appens senast använda lista (MRU). Plattformen hanterar MRU åt dig genom att sortera objekt baserat på när de senast användes, och genom att ta bort det äldsta objektet när listans gräns på 25 objekt nås. Alla appar har sin egen MRU.
Spåra filsystemändringar i bakgrunden Spåra ändringar i filsystemet, även när appen inte körs.
Åtkomst till SD-kortet Du kan lagra och komma åt icke-väsentliga data på ett valfritt microSD-kort, särskilt på lågkostnads-mobilenheter som har begränsad intern lagring.
Snabb åtkomst till filens egenskaper Samla effektivt in en lista över filer och deras egenskaper från ett bibliotek som ska användas via Windows Runtime API:er.

Se även

Access filer och mappar med Windows App SDK- och WinRT-API:er

Åtkomst till filer och mappar med Windows App SDK och .NET API:er

System.IO

  • Last updated on