SaveData, LoadDataa ClearData funkce

Platí pro: aplikace Canvas

Uloží a znovu načte kolekci z úložiště hostitele aplikace.

Popis

Funkce SaveData uloží kolekci pro pozdější použití pod názvem.

Funkce LoadData znovu načte kolekci podle názvu, který byl dříve uložen s SaveData. Tuto funkci nejde použít k načtení kolekce z jiného zdroje.

Funkce ClearData vymaže úložiště pod konkrétním názvem nebo vymaže všechna úložiště přidružená k aplikaci, pokud není zadaný žádný název.

Poznámka:

Název sdílený mezi SaveData, LoadDataa ClearData je klíč, nikoli název souboru. Nemusí to být složité, protože jména jsou pro každou aplikaci jedinečná a nehrozí konflikt jmen. Název nesmí obsahovat žádný z těchto znaků: *".?:\<>|/.
SaveData je omezený na 1 MB dat pro Power Apps spuštěné v Teams a ve webovém prohlížeči. Neexistuje žádný pevný limit pro Power Apps běžící v mobilním přehrávači, ale níže jsou popsány praktické limity.
Nepoužívejte SaveData k ukládání citlivých dat na webu, protože budou uložena ve formátu prostého textu.

Pomocí těchto funkcí můžete zlepšit výkon při spouštění aplikací:

Ukládání dat do mezipaměti ve vzorci App.OnStart při prvním spuštění.
Znovu načíst místní mezipaměť při příštích bězích.

Tyto funkce můžete také použít k přidání jednoduchých funkcí offline do vaší aplikace.

Tyto funkce nelze v prohlížeči použít, když:

Vytvoření aplikace v Power Apps Studio.

Chcete-li aplikaci vyzkoušet, spusťte ji v Power Apps Mobile na iPhone nebo Android zařízení.

Tyto funkce jsou omezeny množstvím dostupné paměti aplikací, které fungují v kolekci v paměti. Dostupná paměť se může lišit v závislosti na faktorech, jako jsou:

Zařízení a operační systém.
Paměť, kterou přehrávač Power Apps používá.
Složitost aplikace s obrazovkami a ovládacími prvky.

Otestujte svou aplikaci s očekávanými scénáři na typu zařízení, která očekáváte, že se aplikace spustí při ukládání velkých dat. Očekávejte obecně 30 až 70 MB dostupné paměti.

Tyto funkce závisí na implicitně definované kolekci pomocí Collect nebo ClearCollect. Nemusíte volat Collect nebo ClearCollect pro načtení dat do kolekce pro jejich definování. Je to běžný případ při použití LoadData po předchozím SaveData. Vše, co je potřeba, je přítomnost těchto funkcí ve vzorci pro implicitní definování struktury kolekce. Další informace viz vytváření a odstraňování proměnných.

Načtená data budou připojena ke sbírce. Před voláním LoadData použijte funkci Clear, pokud chcete začít s prázdnou kolekcí.

Zabezpečení dat

Pečlivě zvažte izolaci a šifrování dat uložených s SaveData daty a rozhodněte se, jestli je to vhodné pro vaše potřeby, zejména pokud jsou zařízení sdílená více uživateli.

Data uložená v SaveData Power Apps jsou izolovaná od ostatních hráčů Power Apps. Data se ukládají na základě ID aplikace a automaticky izolují názvový SaveData prostor mezi Power Apps.

Operační systém a prohlížeč jsou odpovědné za izolaci dat mezi Power Apps a dalšími aplikacemi v zařízení a s weby. Operační systém je například zodpovědný za izolaci dat uložených v Microsoft Outlook od dat uložených v Power Apps a také za izolaci těchto dat z webových stránek jako Bing.com nebo PowerApps.com. Integrované zařízení sandboxu aplikace operačního systému se používají pro SaveData úložiště, které obvykle není přístupné nebo skryté uživateli.

Při použití stejné aplikace je operační systém a prohlížeč také odpovědný za izolaci dat mezi uživateli různých úrovní operačního systému. Pokud například dva různí uživatelé sdílejí počítač a používají dvoje různé přihlašovací údaje Windows, je operační systém zodpovědný za izolaci dat mezi těmito dvěma uživateli Windows.

Data mohou, ale nemusí být izolována mezi různými uživateli Power Apps, pokud je uživatel operačního systému stejný. Ne každý přehrávač Power Apps k tomu přistupuje stejně. Například když je uživatel přihlášen jako stejný uživatel Windows, v přehrávači Power Apps se uživatel odhlásí z Power Apps a přihlásí se jako jiný uživatel Power Apps. Data uložená v aplikaci před změnou uživatele Power Apps mohou být přístupná druhému uživateli Power Apps v rámci stejné aplikace. Data mohou být také odstraněna a první uživatel Power Apps k nim již nemusí mít přístup. Chování se mezi přehrávači Power Apps liší.

Operační systém může také šifrovat data; nebo můžete použít nástroj pro správu mobilních zařízení, například Microsoft Intune. Data uložená při přehrávání aplikace ve webovém prohlížeči nejsou šifrována.

Syntaxe

SaveData( Kolekce, Název )
LoadData( Kolekce, název [, IgnoreNonexistentFile ])

Kolekce – Povinné. Kolekce, která se má uložit nebo načíst.
Název – Povinné. Název úložiště. Pokud chcete uložit a načíst stejnou sadu dat, je nutné použít stejný název. Prostor názvů se nesdílí s jinými aplikacemi. Názvy nesmí obsahovat žádný z těchto znaků: *".?:\<>|/.
IgnorovatNonexistentFile – Volitelné. Logická hodnota označující, co dělat, pokud soubor ještě neexistuje. Použijte false (výchozí) pro vrácení chyby a true pro potlačení chyby.

ClearData( [Název] )

Název – Nepovinné. Název dříve uloženého úložiště .SaveData Pokud není Název k dispozici, je vymazáno veškeré úložiště spojené s aplikací.

Příklady

Vzorec	Popis	Výsledek
SaveData( LocalCache, "MyCache" )	Uložte kolekci LocalCache do zařízení uživatele pod názvem "MyCache", který je vhodný k LoadData pozdějšímu načtení.	Data se ukládají na hostitele aplikace pod názvem „MyCache“.
LoadData( LocalCache, "MyCache" )	Načte kolekci LocalCache ze zařízení uživatele pod názvem "MyCache", která byla dříve uložena s voláním SaveData.	Data jsou načtena z hostitele aplikace pod názvem „MyCache“.
ClearData( "MyCache" )	Vymaže úložiště pod názvem „MyCache“. Veškerá data uložená pod tímto názvem již nebudou k dispozici prostřednictvím LoadData.	Data jsou odstraněna z hostitele aplikace pod názvem „MyCache“.
ClearData()	Vymažte veškeré úložiště spojené s touto aplikací. Data uložená jinými aplikacemi nejsou ovlivněna.	Všechna data jsou odstraněna z hostitele aplikace.

Jednoduchý příklad offline

Následující jednoduchý příklad zachycuje a ukládá jména a obrázky každodenních položek v režimu offline. Ukládá informace do místního úložiště zařízení pro pozdější použití. To umožňuje aplikaci zavřít nebo restartovat zařízení bez ztráty dat.

Poznámka:

Tento příklad používá k pořizování snímků ovládací prvek fotoaparátu. Vzhledem k tomu SaveData , že při spuštění v Teams nebo webovém prohlížeči je omezený na 1 MB dat, nebude tento příklad fungovat s více než několika obrázky. V závislosti na fotoaparátu také nemusí fungovat ani s jedním snímkem. Ppoužijte zařízení k procházení tohoto úplného příkladu nebo odeberte ovládací prvek fotoaparátu a část obrázku z tohoto příkladu, abyste jej mohli spustit v Teams nebo ve webovém prohlížeči.

Vytvořte prázdnou aplikaci plátna s rozvržením tabletu. Pro více informací si přečtěte vytvoření aplikace ze šablony a vyberte Rozložení tabletu v Prázdné aplikaci.
Přidejte ovládací prvek Text input a Camera a uspořádejte je zhruba podle obrázku:
Přidejte ovládací prvek Button.
Poklepáním na ovládací prvek tlačítka změníte text tlačítka na Přidat položku (nebo upravit vlastnost Text).
Nastavte vlastnost OnSelect ovládacího prvku tlačítka do tohoto vzorce, který přidá položku do naší kolekce:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Přidejte další ovládací prvek Button.
Poklepáním na ovládací prvek tlačítka změníte text tlačítka na Uložit data (nebo upravte vlastnost Text).
Nastavte vlastnost OnSelect ovládacího prvku tlačítka do tohoto vzorce, aby se kolekce uložila do místního zařízení:
```
SaveData( MyItems, "LocalSavedItems" )
```
Je lákavé testovat tlačítko, protože to nic neovlivňuje. Chyba se však zobrazí pouze při vytváření obsahu ve webovém prohlížeči. Nejprve uložte aplikaci a otevřete ji na zařízení, než otestujete tento vzorec podle následujících kroků:
Přidejte třetí ovládací prvek Button.
Poklepáním na ovládací prvek tlačítka změníte text tlačítka na Načíst data (nebo upravte vlastnost Text).
Nastavte vlastnost OnSelect ovládacího prvku tlačítka do tohoto vzorce, aby se kolekce načetla z místního zařízení:
```
LoadData( MyItems, "LocalSavedItems" )
```
Přidejte ovládací prvek Gallery s vertikálním rozvržením, které zahrnuje oblast obrázku a textu:
Po zobrazení výzvy vyberte kolekci MyItems jako zdroj dat pro tuto galerii. To nastaví vlastnost Items ovládacího prvku Gallery na tento vzorec:

Ovládací prvek obrázku v šabloně galerie by měl mít výchozí vlastnost Obrázek na ThisItem.Picture a ovládací prvky štítků by měly mít obojí výchozí jejich vlastnosti Text do TatoPoložka.Položka. Zkontrolujte tyto vzorce, pokud po přidání položek v následujících krocích v galerii nic nevidíte.
Umístěte ovládací prvek napravo od ostatních ovládacích prvků:
Uložte aplikaci. Pokud je ukládána poprvé, není třeba ji publikovat. Pokud to není poprvé, publikujte aplikaci po uložení.
Otevřete aplikaci v zařízení, například na telefonu nebo tabletu. SaveData a LoadData nelze ho použít v sadě Studio ani ve webovém prohlížeči. Obnovte seznam aplikací, pokud se aplikace nezobrazí okamžitě, může trvat několik sekund, než se aplikace na vašem zařízení zobrazí. Pomůže vám také odhlášení a opětovné přihlášení k vašemu účtu.

Po stažení aplikace se můžete odpojit od sítě a spustit aplikaci offline.
Zadejte jméno a vyfotografujte položku.
Vyberte tlačítko Přidat položku. Chcete-li načíst svou kolekci, opakujte několikrát přidávání položek.
Vyberte tlačítko Uložit data. Data ve vaší sbírce se tak uloží na místní zařízení.
Zavřete aplikaci. Vaše kolekce v paměti bude ztracena včetně všech názvů položek a obrázků, ale budou stále v úložišti zařízení.
Spusťte znovu aplikaci. Kolekce v paměti se v galerii opět zobrazí jako prázdná.
Vyberte tlačítko Načíst data. Sbírka bude znovu vyplněna z uložených dat v zařízení a vaše položky budou vráceny do galerie. Kolekce byla před voláním LoadData tohoto tlačítka prázdná. Před načtením dat z úložiště nebylo nutné volat funkci Collect ani ClearCollect .
Opět vyberte tlačítko Načíst data. Uložená data budou připojena na konec sbírky a v galerii se objeví posuvník. Pokud chcete nahradit místo připojení, před voláním LoadData funkce nejprve vymažte kolekci pomocí funkce Clear.

Pokročilejší příklad offline

Podrobný příklad najdete v článku o jednoduchých funkcích offline.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-10-10