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.

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.

ストレージは暗号化され、他のユーザーとアプリからは分離された、ローカル デバイス上のプライベートな場所にあります。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.