Fájlok, mappák és tárak kezelése a Windows App SDK-val

Windows App SDK hatékony fájlkezelési képességeket biztosít a csomagolt alkalmazásokhoz. Az Windows.Storage, Windows.Storage.Streams, és Microsoft.Windows.Storage.Pickers névterek API-kat használhatja fájlok különböző adatformátumainak hatékony olvasására és írására, valamint a fájlok és mappák kezelésére.

A Windows 10-tól kezdődően a Windows asztali alkalmazások fájljaival, mappáival, táraival és beállításaival kapcsolatos API-k széles skálája érhető el. Ezek a funkciók a Windows App SDK, Windows SDK és .NET által biztosított Windows App SDK, Windows Runtime (WinRT) és .NET API-k kombinációjával érhetők el.

Adatok olvasása és írása Windows App SDK választók használatával

Az Windows App SDK 1.8-es és újabb verziójában választható API-k érhetők el. Az alábbi témakörök a válogató API-k használatával kapcsolatos információkat tartalmaznak, amelyek lehetővé teszik a felhasználók számára a fájlok és mappák megnyitását és mentését az alkalmazásban:

Téma Description
Fájlok és mappák megnyitása kiválasztókkal a WinUI-ban Windows App SDK fájl- és mappaválasztókkal lehetővé teszi a felhasználók számára a WinUI-alkalmazás fájljainak vagy mappáinak tallózását és kijelölését. A válogató API-k ismerős Windows-élményt nyújtanak, amely segít a felhasználóknak az eszközük és a felhőbeli storage helyek közötti navigálásban. Megtudhatja, hogyan választhatják ki a felhasználók a FileOpenPicker és FolderPicker osztályokkal megnyitni kívánt fájlt vagy mappát.
Fájl mentése Windows App SDK választóval a WinUI-ban WinUI-alkalmazások és más Windows-ügyfélalkalmazások létrehozásakor a felhasználóknak gyakran kell fájlokat, például dokumentumokat, képeket vagy egyéb tartalmakat menteniük az eszközük bizonyos pontjaira. A Windows App SDK biztosítja a FileSavePicker osztályt egy konzisztens, felhasználóbarát felület létrehozásához, amellyel a felhasználók kiválaszthatják a fájlok mentési helyét és a nevüket.

A WinRT és Windows App SDK választók közötti főbb különbségek

Íme néhány fontos különbség a WinRT Windows.Storage.Pickers, amelyet UWP apps használnak.

  • A meglévő Windows.Storage.Pickers API-val ellentétben, amely StorageFile és StorageFolder objektumokat ad vissza, ez az új API karakterláncalapú elérési utakat ad vissza a PickFileResult és PickFolderResult osztályokon keresztül. Ez leegyszerűsíti az API-t, és elkerüli a storage képességekkel kapcsolatos bonyodalmakat emelt szintű forgatókönyvekben.
  • Hasonlóképpen a FileSavePicker.SuggestedSaveFile tulajdonságot (amely egy StorageFile-t adott vissza) lecserélték. Funkcióját mostantól két sztringtulajdonság fedi le: SuggestedFolder és SuggestedFileName. Ezek lehetővé teszik a mentési párbeszédpanel mappájának és fájlnevének javaslatát.
  • Minden új választóelem az asztali alkalmazásokhoz kifejezetten készült, és a WindowId tulajdonság használatával kapcsolja össze a választóelemet a gazdaablakával, lecserélve a WinRT.Interop.InitializeWithWindow.Initialize mintát.
  • Az új választók lehetővé teszik a fejlesztők számára, hogy anélkül használják őket, hogy meg kellene adniuk a FileTypeFilter vagy a FileTypeChoices értékeket. Bár az UWP-választók kivételeket jeleznek, ha ezek a tulajdonságok nincsenek beállítva, az új kiválasztók alapértelmezés szerint az összes fájlt megjelenítik, ha a fejlesztők nem konfigurálják explicit módon ezeket a tulajdonságokat.
  • A HomeGroup helyszín ki lett zárva az új PickerLocationId enumerálásból, mivel a Windows 10-től kezdődően már nem támogatott.
  • FolderPicker.FileTypeFilter ki lett zárva, mivel nem volt funkcionálisan megfelelő a mappaválasztáshoz.
  • Kizárja az elavultként vagy "Ne használja" megjelöléssel ellátott metódusokat és tulajdonságokat. Például PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync stb.
  • Kizárja a többfelhasználós mód metódusait és tulajdonságait, mivel az új API-k jelenleg olyan asztali forgatókönyvekhez vannak kialakítva, ahol minden felhasználó saját interaktív munkamenetet használ, és minden munkamenet teljesen független az eszközön található többi munkamenetétől. Ez ellentétben áll az Xbox vagy más többfelhasználós eszközökkel.

Adatok elérése WinRT tárolási API-kkal

A csomagolt alkalmazások hozzáférhetnek az UWP-alkalmazások számára elérhető összes WinRT-tároló API-hoz. Akár meglévő UWP-alkalmazást migrál, akár új alkalmazást hoz létre, ezekkel az API-kkal adatokat olvashat és írhat. A storage API-k WinUI 3-alkalmazásokban való használatára vonatkozó példákért lásd Access Windows App SDK és WinRT API-kkal rendelkező fájlokat és mappákat.

A .NET fájl API-k használata az adatokhoz való hozzáféréshez

A WinRT API-k mellett a csomagolt asztali alkalmazások a System.IO névtérben lévő .NET API-kat is használhatják az adatok olvasásához és írásához. Új WinUI-project létrehozásakor a Package.appxmanifest fájl a következő beállítást tartalmazza:

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

A korlátozott képességek deklarálása teljes hozzáférést biztosít a fájlrendszerhez, a beállításjegyzékhez és más korlátozott képességekhez. További információ: Korlátozott képesség deklarációk. Más szóval, az alkalmazásnak ugyanaz a hozzáférése van a fájlrendszerhez, mint bármely más .NET asztali alkalmazásnak, amikor a .NET fájl API-kat használják.

Az .NET API-k WinUI-alkalmazásokban való használatára vonatkozó példákért lásd Access Windows App SDK és .NET API-kat tartalmazó fájlokat és mappákat.

További erőforrások fájlok és mappák használatára

Ha csomagolt WinUI-alkalmazásokat fejleszt, a WinRT storage API-k hatékony eszközök lehetnek az adatok olvasásához és írásához. Az alábbi témakörök rengeteg információt nyújtanak azoknak a fejlesztőknek, akik használni szeretnék ezeket az API-kat az alkalmazásaikban.

Téma Description
Fájlok és mappák számbavétele és lekérdezése Férjen hozzá a fájlokhoz és mappákhoz mappákban, könyvtárakban, eszközökön vagy hálózati helyeken. Fájl- és mappa-lekérdezések létrehozásával is lekérdezheti a fájlokat és mappákat egy helyen.
Fájl létrehozása, írása és olvasása Fájl olvasása és írása egy StorageFile objektummal.
Ajánlott eljárások fájlokba való íráshoz Ismerje meg a FileIO és PathIO osztályok különböző fájlírási módszereinek használatát.
Fájltulajdonságok lekérése A StorageFile objektum által képviselt fájlok tulajdonságainak lekérése –legfelső szintű, alapszintű és kiterjesztett .
A HomeGroup-tartalom elérése A felhasználó HomeGroup mappájában tárolt tartalmakhoz való hozzáférés, beleértve a képeket, zenéket és videókat is.
A Microsoft OneDrive fájlok rendelkezésre állásának megállapítása Állapítsa meg, hogy elérhető-e Microsoft OneDrive fájl a StorageFile.IsAvailable tulajdonság használatával.
Fájlok és mappák a Zene, Képek és Videók tárakban Meglévő zene-, kép- vagy videómappákat adhat hozzá a megfelelő tárakhoz. Mappákat is eltávolíthat a tárakból, lekérheti a tárak mappáinak listáját, és felderítheti a tárolt fényképeket, zenéket és videókat.
Legutóbb használt fájlok és mappák nyomon követése A felhasználó által gyakran használt fájlok nyomon követéséhez vegye fel őket az alkalmazás legutóbb használt listájára (MRU). A platform úgy kezeli az MRU-t, hogy az elemeket a legutóbbi hozzáférésük időpontjától függően rendezi, és eltávolítja a legrégebbi elemet, amikor eléri a lista 25 elemre vonatkozó korlátját. Minden alkalmazás saját MRU-kkal rendelkezik.
A fájlrendszer változásainak nyomon követése a háttérben Kövesse nyomon a fájlrendszer változásait, még akkor is, ha az alkalmazás nem fut.
Hozzáférés az SD-kártyához A nem alapvető adatokat opcionális microSD-kártyán tárolhatja és férhet hozzájuk, különösen olyan alacsony költségű mobileszközökön, amelyek korlátozott belső tárolóval rendelkeznek.
Gyors hozzáférés a fájltulajdonságokhoz Hatékonyan gyűjtheti össze a fájlok és tulajdonságaik listáját egy tárból, hogy a Windows Runtime API-k segítségével használhassa.

Lásd még

Hozzáférés fájlokhoz és mappákhoz a Windows App SDK-val és WinRT API-kkal

Hozzáférés a fájlokhoz és mappákhoz a Windows App SDK és .NET API-k segítségével

System.IO

  • Last updated on