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

Sada Windows App SDK poskytuje výkonné možnosti správy souborů pro zabalené aplikace. Pomocí rozhraní API z oborů názvů Windows.Storage, Windows.Storage.Streams a Microsoft.Windows.Storage.Pickers můžete efektivně číst a zapisovat různé formáty dat v souborech a také spravovat soubory a složky.

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 sady Windows App SDK, prostředí Windows Runtime (WinRT) a rozhraní .NET API poskytované sadou Windows App SDK, Windows SDK a .NET SDK.

Použití nástrojů pro výběr sady Windows App SDK ke čtení a zápisu dat

V sadě Windows App SDK verze 1.8 a novější jsou k dispozici výběrová rozhraní API. 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ástrojů pro výběr souborů a složek sady 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ý zážitek systému Windows, který uživatelům pomáhá orientovat se po jejich zařízeních a umístěních cloudového úložiště. Zjistěte, jak uživatelům umožnit, aby vybrali soubor nebo složku, které se mají otevřít pomocí tříd FileOpenPicker a FolderPicker .
Uložení souboru pomocí výběru sady 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í. Sada Windows App SDK poskytuje třídu FileSavePicker pro vytvoření konzistentního a uživatelsky přívětivého rozhraní, které umožňuje uživatelům zvolit, kam se mají ukládat soubory a jak je pojmenovat.

Hlavní rozdíly mezi nástroji pro výběr WinRT a nástroji pro výběr v rámci Windows App SDK

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 rozhraní API Windows.Storage.Pickers , které vrací objekty StorageFile a StorageFolder , vrátí toto nové rozhraní API 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 úložiště ve scénářích se zvýšenými oprávněními.
• Podobně FileSavePicker.SuggestedSaveFile vlastnost (která vrátila StorageFile) byla nahrazena. Jeho funkce jsou nyní pokryty dvěma řetězcovými vlastnostmi: 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 bez zadání 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í domácí skupiny bylo vyloučeno z nového výčtu PickerLocationId , protože již není podporováno počínaje Windows 10.
• 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 úložiště WinRT

Zabalené aplikace mají přístup ke všem rozhraním API úložiště WinRT, která jsou dostupná pro aplikace pro UPW. 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 najdete v tématu Přístup k souborům a složkám se sadou Windows App SDK a rozhraními API WinRT.

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

Kromě rozhraní API WinRT můžou zabalené desktopové aplikace používat rozhraní .NET API v oboru názvů System.IO ke čtení a zápisu dat. Při vytvoření nového projektu WinUI 3 obsahuje jeho Package.appxmanifest soubor 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 možnostem. Další informace najdete v tématu Deklarace omezených schopností. Jinými slovy, aplikace má stejný přístup k systému souborů jako jakákoli jiná desktopová aplikace .NET při použití rozhraní API souborů .NET.

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

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

Pokud vyvíjíte zabalené aplikace WinUI, může být rozhraní API úložiště WinRT 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řístup 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ů tříd FileIO a PathIO .
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	Přístup k obsahu uloženému ve složce Domácí skupina uživatele, včetně obrázků, hudby a videí
Určení dostupnosti souborů Microsoft OneDrivu	Pomocí vlastnosti StorageFile.IsAvailable zjistěte, jestli je k dispozici soubor Microsoft OneDrivu.
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 k kartě SD	Na volitelné kartě microSD můžete ukládat a přistupovat k datům, která nejsou nezbytná, 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 prostředí Windows Runtime.

Viz také

Přístup k souborům a složkám pomocí sady Windows App SDK a rozhraní API WinRT

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

System.IO