Správa souborů, složek a knihoven pomocí Windows App SDK

Windows App SDK poskytuje výkonné možnosti správy souborů pro zabalené aplikace. Můžete použít rozhraní API z jmenných prostorů Windows.Storage, Windows.Storage.Streams a Microsoft.Windows.Storage.Pickers pro efektivní čtení a zápis různých datových formátů do souborů, stejně jako pro správu souborů a složek.

Existuje celá řada rozhraní API souvisejících se soubory, složkami, knihovnami a nastavením pro desktopové aplikace pro Windows počínaje Windows 10. Tyto funkce jsou dostupné prostřednictvím kombinace Windows App SDK, Windows Runtime (WinRT) a rozhraní API .NET poskytovaných Windows App SDK, Windows SDK a .NET SDK.

Čtení a zápis dat pomocí výběrových prvků Windows App SDK

V Windows App SDK verze 1.8 a novějších jsou k dispozici rozhraní API pro výběr. Následující témata obsahují informace o používání rozhraní API pro výběr, která uživatelům umožní otevírat a ukládat soubory a složky ve vaší aplikaci:

Téma	Description
Otevření souborů a složek pomocí výběrů ve WinUI	Pomocí nástroje pro výběr souborů a složek Windows App SDK umožníte uživatelům procházet a vybírat soubory nebo složky v aplikaci WinUI. Rozhraní API pro výběr poskytují známé prostředí ve Windows, které uživatelům pomáhá procházet jejich zařízení a umístění cloudového úložiště. Zjistěte, jak umožnit uživatelům vybrat soubor nebo složku, které se mají otevřít pomocí tříd FileOpenPicker a FolderPicker.
Uložte soubor pomocí výběru Windows App SDK ve WinUI	Při vytváření aplikací WinUI a jiných klientských aplikací pro Windows uživatelé často potřebují ukládat soubory, jako jsou dokumenty, obrázky nebo jiný obsah, do konkrétních umístění na svém zařízení. Windows App SDK poskytuje třídu FileSavePicker k vytvoření konzistentního a uživatelsky přívětivého rozhraní, které umožňuje uživatelům zvolit, kam se mají soubory ukládat a jak je pojmenovat.

Hlavní rozdíly mezi WinRT a Windows App SDK selektory

Tady jsou některé klíčové rozdíly od WinRT Windows.Storage.Pickers používané aplikacemi pro UWP:

• Na rozdíl od existujícího Windows Storage. Pickers API, které vrací StorageFile a StorageFolder objekty, toto nové rozhraní API vrátí cesty založené na řetězcích prostřednictvím tříd PickFileResult a PickFolderResult. To zjednodušuje rozhraní API a vyhnete se komplikacím s možnostmi storage ve scénářích se zvýšenými oprávněními.
• Podobně byla nahrazena vlastnost FileSavePicker.SuggestedSaveFile (která vrátila StorageFile). Jeho funkce jsou teď pokryté dvěma vlastnostmi řetězce: SuggestedFolder a SuggestedFileName. To vám umožní navrhnout název složky a souboru pro dialogové okno pro uložení.
• Všechny nové nástroje pro výběr jsou navržené speciálně pro desktopové aplikace a pomocí vlastnosti WindowId propojí výběr s oknem hostitele a nahradí WinRT.Interop.InitializeWithWindow.Initialize vzor.
• Nové nástroje pro výběr umožňují vývojářům používat je, aniž by museli zadat FileTypeFilter nebo FileTypeChoices. I když výběry UWP mohou vytvářet výjimky, pokud tyto vlastnosti nejsou nastaveny, nové výběry ve výchozím nastavení zobrazují všechny soubory, pokud vývojáři explicitně nenastaví tyto vlastnosti.
• Umístění HomeGroup bylo vyloučeno z nového výčtu PickerLocationId, protože už se ve verzi Windows 10 nepodporuje.
• FolderPicker.FileTypeFilter byl vyloučen, protože nebyl funkčně vhodný pro výběr složky.
• Vyloučení metod a vlastností, které jsou již označené jako zastaralé nebo nepoužívat Například PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync, a podobně.
• Vyloučení metod a vlastností pro režim s více uživateli, protože nová rozhraní API jsou aktuálně navržená pro desktopové scénáře, kde má každý uživatel vlastní interaktivní relaci a každá relace je zcela nezávislá na ostatních relacích na zařízení. To je na rozdíl od Xboxu nebo jiných zařízení s více uživateli.

Přístup k datům pomocí rozhraní API pro úložiště WinRT

Zabalené aplikace mají přístup ke všem rozhraním API úložiště WinRT, která jsou k dispozici pro aplikace UWP. Bez ohledu na to, jestli migrujete existující aplikaci pro UPW nebo vytváříte novou aplikaci, můžete tato rozhraní API použít ke čtení a zápisu dat. Příklady použití rozhraní API úložiště v aplikaci WinUI 3 najdete v tématu Přístup k souborům a složkám pomocí rozhraní API Windows App SDK a WinRT.

Použijte rozhraní API souborů .NET pro přístup k datům

Kromě rozhraní API WinRT můžou zabalené desktopové aplikace používat rozhraní API .NET v oboru názvů System.IO ke čtení a zápisu dat. Když se vytvoří nový project WinUI, jeho soubor Package.appxmanifest obsahuje následující nastavení:

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

Deklarování této omezené schopnosti poskytuje úplný přístup k systému souborů, registru a dalším omezeným schopnostem. Další informace najdete v tématu Deklarace omezených schopností. Jinými slovy, aplikace má stejnou access do systému souborů jako jakákoli jiná desktopová aplikace .NET při použití rozhraní API souborů .NET.

Příklady použití rozhraní API .NET v aplikaci WinUI najdete v tématu Přístup k souborům a složkám pomocí Windows App SDK a rozhraní API .NET.

Další zdroje informací pro práci se soubory a složkami

Pokud vyvíjíte zabalené aplikace WinUI, může být rozhraní API winRT storage výkonným nástrojem pro čtení a zápis dat. Následující témata UPW poskytují vývojářům širokou škálu informací, které chtějí využít tato rozhraní API ve svých aplikacích.

Téma	Description
Vytvoření výčtu a dotazování souborů a složek	Přistupujte k souborům a složkám ve složce, knihovně, zařízení nebo síťovém umístění. Soubory a složky v umístění můžete také dotazovat tak, že vytvoříte dotazy na soubory a složky.
Vytvoření, zápis a čtení souboru	Čtení a zápis souboru pomocí objektu StorageFile.
Osvědčené postupy pro zápis do souborů	Seznamte se s osvědčenými postupy pro používání různých metod zápisu souborů FileIO a PathIO třídy.
Získání vlastností souboru	Získejte vlastnosti – nejvyšší úroveň, základní a rozšířené – pro soubor reprezentovaný objektem StorageFile.
Přístup k obsahu domácí skupiny	Access obsah uložený ve složce Domácí skupina uživatele, včetně obrázků, hudby a videí.
Určení dostupnosti souborů Microsoft OneDrive	Pomocí vlastnosti StorageFile.IsAvailable zjistěte, jestli je k dispozici soubor Microsoft OneDrive.
Soubory a složky v knihovnách Hudba, Obrázky a Videa	Přidejte do odpovídajících knihoven existující složky hudby, obrázků nebo videí. Můžete taky odebrat složky z knihoven, získat seznam složek v knihovně a zjišťovat uložené fotky, hudbu a videa.
Sledování naposledy použitých souborů a složek	Sledujte soubory, ke kterým uživatelé často přistupují, tak, že je přidáte do seznamu naposledy použitých položek (MRU) vaší aplikace. Platforma spravuje mru za vás řazením položek podle toho, kdy byly naposledy přístupné, a odebráním nejstarší položky při dosažení limitu 25 položek seznamu. Všechny aplikace mají vlastní MRU.
Sledování změn systému souborů na pozadí	Sledujte změny systému souborů, i když aplikace není spuštěná.
Přístup ke kartě SD	Data, která nejsou nezbytná, můžete ukládat a přistupovat k nim na volitelné kartě microSD, zejména na nízkonákladových mobilních zařízeních s omezeným interním úložištěm.
Rychlý přístup k vlastnostem souboru	Efektivně shromážděte seznam souborů a jejich vlastností z knihovny, které se mají použít prostřednictvím rozhraní API Windows Runtime.

Viz také

Access soubory a složky pomocí rozhraní API Windows App SDK a WinRT

Přístup k souborům a složkám pomocí Windows App SDK a .NET API

System.IO