PowerApps の SaveData および LoadData 関数SaveData and LoadData functions in PowerApps

コレクションを保存および再読み込みします。Saves and re-loads a collection.

説明Description

SaveData 関数は、後で名前から使用できるようにコレクションを格納します。The SaveData function stores a collection for later use under a name.

LoadData 関数は、既に SaveData で保存されている名前でコレクションを再読み込みします。The LoadData function re-loads a collection by name that was previously saved with SaveData. 別のソースからコレクションを読み込む場合、この関数は使用できません。You can't use this function to load a collection from another source.

内のデータをキャッシュすることによって、アプリ起動時のパフォーマンスを向上させるためにこれらの関数を使用して、 App.OnStart 数式の最初の実行と後続の実行にローカル キャッシュを再読み込みします。Use these functions to improve app-startup performance by caching data in the App.OnStart formula on a first run and then re-loading the local cache on subsequent runs. 追加する、これらの関数を使用することもできます。単純なオフライン機能をアプリにします。You can also use these functions to add simple offline capabilities to your app.

PowerApps Studio でアプリを作成するとき、または web player アプリを実行するときに、ブラウザー内でこれらの関数を使うことはできません。You can't use these functions inside a browser, either when authoring the app in PowerApps Studio or when running the app in the web player. アプリをテストするには、PowerApps Mobile で iPhone または Android デバイスで実行します。To test your app, run it in PowerApps Mobile on an iPhone or Android device.

これらの関数は、メモリ内コレクションで動作するために、利用可能なアプリのメモリの量によって制限されます。These functions are limited by the amount of available app memory because they operate on an in-memory collection. 使用可能なメモリは、デバイスとオペレーティング システム、PowerApps プレーヤーを使用して、メモリ、および画面とコントロールの観点から、アプリの複雑さによって異なります。Available memory can vary depending on the device and operating system, the memory that the PowerApps player uses, and the complexity of the app in terms of screens and controls. メガバイト単位を複数のデータを格納する場合は、アプリケーションの実行を予定されているデバイスで想定されるシナリオを使用してアプリをテストします。If you store more than a few megabytes of data, test your app with expected scenarios on the devices on which you expect the app to run. 一般に、使用可能なメモリの 30 日と 70 のメガバイト数の間にあるはずです。You should generally expect to have between 30 and 70 megabytes of available memory.

LoadData はコレクションを作成しません。この関数は、既存のコレクションの格納しか行いません。LoadData doesn't create the collection; the function only fills an existing collection. 最初に Collect を使用して、適切なでコレクションを作成する必要があります。You must first create the collection with the correct columns by using Collect. 読み込まれたデータがコレクションに追加されます。使用して、 クリア 関数の最初に空のコレクションを開始する場合。The loaded data will be appended to the collection; use the Clear function first if you want to start with an empty collection.

ストレージは暗号化され、他のユーザーとアプリからは分離された、ローカル デバイス上のプライベートな場所にあります。Storage is encrypted and in a private location on the local device, isolated from other users and other apps.

構文Syntax

SaveData( Collection, Name )SaveData( Collection, Name )
LoadData( Collection, Name [, IgnoreNonexistentFile ])LoadData( Collection, Name [, IgnoreNonexistentFile ])

  • Collection - 必須。Collection - Required. 格納または読み込みの対象となるコレクション。Collection to be stored or loaded.
  • Name - 必須。Name - Required. ストレージの名前。Name of the storage. 同じデータ セットを保存し、読み込むには、同じ名前を使用する必要があります。You must use the same name to save and load the same set of data. 名前空間は、他のアプリまたはユーザーとは共有されません。The name space isn't shared with other apps or users.
  • IgnoreNonexistentFile - 省略可能。IgnoreNonexistentFile - Optional. 一致するファイルが見つからないときに LoadData 関数でエラーを表示するか無視するかを示すブール値 (true/false)。Boolean (true/false) value that indicates whether LoadData function should display or ignore errors when it can't locate a matching file. false を指定した場合、エラーが表示されます。If you specify false, errors will be displayed. true を指定した場合、エラーは無視されます。これは、オフラインのシナリオで役立ちます。If you specify true, errors will be ignored, which is useful for offline scenarios. SaveData は、デバイスがオフライン (つまり、Connection.Connected の状態が false) の場合に、ファイルを作成します。SaveData may create a file if the device is offline (that is, if the Connection.Connected status is false).

Examples

数式Formula 説明Description 結果Result
If(Connection.Connected, ClearCollect(LocalTweets, Twitter.SearchTweet("PowerApps", {maxResults:100})),LoadData(LocalTweets, "Tweets", true))If(Connection.Connected, ClearCollect(LocalTweets, Twitter.SearchTweet("PowerApps", {maxResults: 100})),LoadData(LocalTweets, "Tweets", true)) デバイスが接続されている場合、Twitter サービスから LocalTweets コレクションを読み込みます。それ以外の場合は、ローカル ファイル キャッシュからコレクションを読み込みます。If the device is connected, load the LocalTweets collection from the Twitter service; otherwise, load the collection from the local file cache. デバイスがオンラインであるかオフラインであるかによって、コンテンツがレンダリングされます。The content is rendered whether the device is online or offline.
SaveData(LocalTweets, "Tweets")SaveData(LocalTweets, "Tweets") LocalTweets コレクションをデバイスにローカル ファイル キャッシュとして保存します。Save the LocalTweets collection as a local file cache on the device. LoadData がコレクションに読み込むことができるように、データはローカルに保存されます。Data is saved locally so that LoadData can load it into a collection.