Funções SaveData e LoadData no PowerAppsSaveData and LoadData functions in PowerApps

Guarda e carrega novamente uma coleção.Saves and re-loads a collection.

DescriçãoDescription

A função SaveData armazena uma coleção para utilização posterior com um nome.The SaveData function stores a collection for later use under a name.

A função LoadData carrega novamente através do nome uma coleção guardada anteriormente com a função SaveData.The LoadData function re-loads a collection by name that was previously saved with SaveData. Não pode utilizar esta função para carregar uma coleção a partir de outra origem.You can't use this function to load a collection from another source.

A função LoadData não cria a coleção, apenas preenche uma coleção existente.LoadData doesn't create the collection; the function only fills an existing collection. Tem primeiro de criar a coleção com as colunas corretas ao utilizar a função Collect.You must first create the collection with the correct columns by using Collect.

O armazenamento é encriptado numa localização privada no dispositivo local, isolada de outros utilizadores e aplicações.Storage is encrypted and in a private location on the local device, isolated from other users and other apps.

SintaxeSyntax

SaveData( Coleção, Nome )SaveData( Collection, Name )
LoadData( Coleção, Nome [, IgnorarFicheiroNãoExistente ])LoadData( Collection, Name [, IgnoreNonexistentFile ])

  • Coleção – necessário.Collection - Required. Coleção a armazenar ou carregar.Collection to be stored or loaded.
  • Nome – necessário.Name - Required. Nome do armazenamento.Name of the storage. Tem de utilizar o mesmo nome para guardar e carregar o mesmo conjunto de dados.You must use the same name to save and load the same set of data. O espaço de nomes não é partilhado com outras aplicações ou utilizadores.The name space isn't shared with other apps or users.
  • IgnorarFicheiroNãoExistente – opcional.IgnoreNonexistentFile - Optional. O valor booleano (true/false) que indica se a função LoadData deve apresentar ou ignorar erros quando não consegue localizar um ficheiro correspondente.Boolean (true/false) value that indicates whether LoadData function should display or ignore errors when it can't locate a matching file. Se especificar false, os erros serão apresentados.If you specify false, errors will be displayed. Se especificar true, os erros serão ignorados, o que é útil para cenários offline.If you specify true, errors will be ignored, which is useful for offline scenarios. A função SaveData pode criar um ficheiro se o dispositivo estiver offline (ou seja, se o estado Connection.Connected for false).SaveData may create a file if the device is offline (that is, if the Connection.Connected status is false).

ExemplosExamples

FórmulaFormula DescriçãoDescription ResultadoResult
If(Connection.Connected, ClearCollect(TweetsLocais, Twitter.SearchTweet("PowerApps", {maxResults: 100})),LoadData(TweetsLocais, "Tweets", true))If(Connection.Connected, ClearCollect(LocalTweets, Twitter.SearchTweet("PowerApps", {maxResults: 100})),LoadData(LocalTweets, "Tweets", true)) Se o dispositivo estiver ligado, carregue a coleção TweetsLocais a partir do serviço do Twitter. Caso contrário, carregue a coleção a partir da cache de ficheiros local.If the device is connected, load the LocalTweets collection from the Twitter service; otherwise, load the collection from the local file cache. O conteúdo é composto quer o dispositivo esteja online ou offline.The content is rendered whether the device is online or offline.
SaveData (TweetsLocais, "Tweets")SaveData(LocalTweets, "Tweets") Guarde a coleção TweetsLocais como uma cache de ficheiros local no dispositivo.Save the LocalTweets collection as a local file cache on the device. Os dados são guardados localmente para que a função LoadData possa carregá-los para uma coleção.Data is saved locally so that LoadData can load it into a collection.