設定と他のアプリデータを保存して取得する

[アーティクル]
12/29/2023

アプリデータは、特定のアプリによって作成および管理される変更可能なデータです。アプリデータには、ランタイム状態、アプリ設定、ユーザー設定、参照コンテンツ (たとえば、辞書アプリの辞書定義)、その他の設定が含まれます。アプリデータは、ユーザーデータ、ユーザーがアプリを使用するときに作成および管理するデータとは異なります。ユーザーデータには、ドキュメントまたはメディアファイル、電子メールまたは通信トランスクリプト、またはユーザーが作成したコンテンツを保持するデータベースレコードが含まれます。ユーザーデータは、複数のアプリにとって有用または意味のある場合があります。多くの場合、これは、ドキュメントなどのアプリ自体に依存しないエンティティとしてユーザーが操作または送信するデータです。

アプリデータに関する重要な注意事項: アプリデータの有効期間は、アプリの有効期間に関連付けられています。アプリが削除されると、結果としてすべてのアプリデータが失われます。アプリデータを使用して、ユーザーデータや、ユーザーが貴重でかけがえのないものとして認識する可能性のあるものを格納しないでください。この種の情報を格納するには、ユーザーのライブラリと Microsoft OneDrive を使用することをお勧めします。アプリデータは、アプリ固有のユーザー設定、設定、お気に入りを格納するのに最適です。

アプリデータの種類

アプリデータには、設定とファイルの 2 種類があります。

設定

設定を使用して、ユーザー設定とアプリケーションの状態情報を格納します。アプリデータ API を使用すると、設定を簡単に作成および取得できます (この記事の後半で例をいくつか紹介します)。

アプリ設定に使用できるデータ型を次に示します。

UInt8、Int16、UInt16、Int32、UInt32、Int64、UInt64、Single、Double
Boolean
Char16、文字列
DateTime、TimeSpan
- C#/.NET の場合は、System.DateTimeOffset、System.TimeSpan を使用します。
GUID、ポイント、サイズ、Rect
ApplicationDataCompositeValue: アトミックにシリアル化および逆シリアル化する必要がある、一連の関連したアプリの設定。複合設定を使用すると、相互依存設定のアトミック更新を簡単に処理できます。システムは、コンカレントアクセスとローミング中に複合設定の整合性を確保します。複合設定は少量のデータ用に最適化されており、大規模なデータセットに使用するとパフォーマンスが低下する可能性があります。

ファイル

ファイルを使用してバイナリデータを格納するか、独自のカスタマイズされたシリアル化された型を有効にします。

アプリデータストアにアプリデータを格納する

アプリがインストールされると、システムは設定とファイル用のユーザーごとの独自のデータストアを提供します。システムが物理ストレージを管理し、データが他のアプリや他のユーザーから確実に分離されるようにするため、このデータが存在する場所や方法を知る必要はありません。システムは、ユーザーがアプリに更新プログラムをインストールするときに、これらのデータストアの内容を保持し、アプリがアンインストールされたときにこれらのデータストアの内容を完全かつクリーンに削除します。

アプリデータストア内には、各アプリにシステム定義のルートディレクトリがあり、1 つはローカルファイル用、1 つはローミングファイル用、1 つは一時ファイル用です。アプリは、これらの各ルートディレクトリに新しいファイルと新しいコンテナーを追加できます。

ローカルアプリデータ

ローカルアプリデータは、アプリセッション間で保持する必要があり、アプリデータのローミングには適していない情報に使用する必要があります。他のデバイスには適用できないデータもここに保存する必要があります。保存されるローカルデータには一般的なサイズ制限はありません。ローカルアプリデータストアは、ローミングしても意味のないデータや、大規模なデータセットに使用します。

ローカルアプリデータストアを取得する

ローカルアプリデータの読み取りまたは書き込みを行う前に、ローカルアプリデータストアを取得する必要があります。ローカルアプリデータストアを取得するには、ApplicationData.Local 設定プロパティを使用して、アプリケーションのローカル設定を ApplicationDataContainer オブジェクトとして取得します。 ApplicationData.LocalFolder プロパティを使用して、StorageFolder オブジェクト内のファイルを取得します。 ApplicationData.LocalCacheFolder プロパティを使用して、バックアップと復元に含まれていないファイルを保存できるローカルアプリデータストア内のフォルダーを取得します。

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

簡単なローカル設定を作成して取得する

設定を作成または書き込むには、ApplicationDataContainer.Values プロパティを使用して、前の手順で取得した localSettings コンテナーの設定にアクセスします。 exampleSetting という名前の設定を作成する例を次に示します。

// Simple setting

localSettings.Values["exampleSetting"] = "Hello Windows";

設定を取得するには、設定の作成に使用したのと同じ ApplicationDataContainer.Values プロパティを使用します。この例では、先ほど作成した設定を取得する方法を示します。

// Simple setting
Object value = localSettings.Values["exampleSetting"];

ローカル複合値を作成して取得する

複合値を作成または書き込むには、ApplicationDataCompositeValue オブジェクトを作成します。この例では、exampleCompositeSetting という名前の複合設定を作成し、localSettings コンテナーに追加します。

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
    new Windows.Storage.ApplicationDataCompositeValue();
composite["intVal"] = 1;
composite["strVal"] = "string";

localSettings.Values["exampleCompositeSetting"] = composite;

この例では、先ほど作成した複合値を取得する方法を示します。

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
   (Windows.Storage.ApplicationDataCompositeValue)localSettings.Values["exampleCompositeSetting"];

if (composite == null)
{
   // No data
}
else
{
   // Access data in composite["intVal"] and composite["strVal"]
}

ローカルファイルの作成および読み取り

ローカルアプリデータストアでファイルを作成および更新するには、Windows.Storage.StorageFolder.CreateFileAsync や Windows.Storage.FileIO.WriteTextAsync などのファイル API を使用します。この例では、localFolder コンテナーの dataFile.txt と名付けられたファイルを作成し、現在の日付と時刻をファイルに書き込みます。 CreationCollisionOption 列挙の ReplaceExisting 値は、ファイルが既に存在する場合は置き換えることを示します。

async void WriteTimestamp()
{
   Windows.Globalization.DateTimeFormatting.DateTimeFormatter formatter = 
       new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");

   StorageFile sampleFile = await localFolder.CreateFileAsync("dataFile.txt", 
       CreationCollisionOption.ReplaceExisting);
   await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTimeOffset.Now));
}

ローカルアプリデータストアでファイルを開いて読み取るには、Windows.Storage.StorageFolder.GetFileAsync、Windows.Storage.StorageFile.GetFileFromApplicationUriAsync、Windows.Storage.FileIO.ReadTextAsync などのファイル API を使用します。次の使用例は、前の手順で作成した dataFile.txt ファイルを開き、そのファイルから日付を読み取ります。さまざまな場所からファイルリソースを読み込む方法の詳細については、「ファイルリソースを読み込む方法」を参照してください。

async void ReadTimestamp()
{
   try
   {
      StorageFile sampleFile = await localFolder.GetFileAsync("dataFile.txt");
      String timestamp = await FileIO.ReadTextAsync(sampleFile);
      // Data is contained in timestamp
   }
   catch (Exception)
   {
      // Timestamp not found
   }
}

データをローミング

警告

ローミングデータと設定は、Windows 11 ではサポートされなくなりました。代替として推奨されるのは、Azure App Service です。 Azure App Service は、広くサポートされており、ドキュメントが豊富で、信頼性が高く、iOS、Android、Web などのクロスプラットフォームやクロスエコシステムのシナリオに対応しています。

次のドキュメントは、Windows 10 バージョン 1909 以前に適用されます。

アプリでローミングデータを使用する場合、ユーザーはアプリのアプリデータを複数のデバイス間で簡単に同期させることができます。ユーザーが複数のデバイスにアプリをインストールした場合、OS はアプリデータを同期し続け、ユーザーが 2 台目のデバイスでアプリに対して行う必要があるセットアップ作業の量を減らします。ローミングを使用すると、ユーザーは、別のデバイスでも中断した場所で、リストの作成などのタスクを続行することもできます。 OS では、ローミングデータが更新されるとクラウドにレプリケートされ、アプリがインストールされている他のデバイスにデータが同期されます。

OS では、各アプリがローミングできるアプリデータのサイズが制限されます。「ApplicationData.RoamingStorageQuota」を参照してください。アプリがこの制限に達した場合、アプリの合計ローミングアプリデータが再び制限を下回るまで、アプリのアプリデータはクラウドにレプリケートされません。このため、ローミングデータは、ユーザー設定、リンク、および小さなデータファイルにのみ使用することをお勧めします。

アプリのローミングデータは、必要な時間間隔内に何らかのデバイスからユーザーがアクセスする限り、クラウドで利用できます。ユーザーがこの時間間隔より長くアプリを実行しない場合、そのローミングデータはクラウドから削除されます。ユーザーがアプリをアンインストールした場合、ローミングデータはクラウドから自動的に削除されず、保持されます。ユーザーが時間間隔内にアプリを再インストールすると、ローミングデータはクラウドから同期されます。

ローミングデータですべきこととしてはいけないこと

ローミングは、ユーザー設定とカスタマイズ、リンク、および小さなデータファイルに使用します。たとえば、ローミングを使用して、すべてのデバイスでユーザーの背景色の設定を保持します。
ローミングを使用して、ユーザーがデバイス間でタスクを続行できるようにします。たとえば、下書きメールの内容や閲覧者アプリで最近表示されたページなどのアプリデータをローミングします。
アプリデータを更新して、DataChanged イベントを処理します。このイベントは、クラウドからのアプリデータの同期が完了したばかりの場合に発生します。
生データではなくコンテンツへの参照をローミングします。たとえば、オンライン記事のコンテンツではなく URL をローミングします。
時間が重要な重要な設定には、RoamingSettings に関連付けられた HighPriority 設定を使用します。
デバイスに固有のアプリデータをローミングしないでください。ローカルファイルリソースへのパス名など、一部の情報はローカルでのみ関連します。ローカル情報をローミングする場合は、セカンダリデバイスで情報が有効でない場合にアプリが回復できることを確認します。
大量のアプリデータのセットをローミングしないでください。アプリがローミングできるアプリデータの量には制限があります。この最大値を取得するには、RoamingStorageQuota プロパティを使用します。アプリがこの制限に達した場合、アプリデータストアのサイズが制限を超えなくなるまで、データはローミングできません。アプリを設計するときは、制限を超えないように、より大きなデータにバインドする方法を検討してください。たとえば、ゲームの状態を保存するためにそれぞれ 10 KB (キロバイト)が必要な場合、アプリではユーザーが最大 10 個のゲームを格納できる場合があります。
インスタント同期に依存するデータにはローミングを使用しないでください。 Windows では、インスタント同期は保証されておらず、ユーザーがオフラインまたは待ち時間の長いネットワーク上にある場合、ローミングが大幅に遅延する可能性があります。 UI がインスタント同期に依存していないことを確認します。
頻繁に変更されるデータにはローミングを使用しないでください。たとえば、アプリが頻繁に変化する情報 (1 秒ごとの曲の位置など) を追跡する場合は、ローミングアプリデータとして保存しないでください。代わりに、現在再生中の曲など、良好なユーザーエクスペリエンスを提供する頻度の低い表現を選択してください。

ローミングの前提条件

Microsoft アカウントを使用してデバイスにログオンする場合、どのユーザーもアプリデータのローミングの恩恵を受けることができます。ただし、ユーザーとグループポリシー管理者は、デバイス上のローミングアプリデータをいつでもオフにできます。ユーザーが Microsoft アカウントを使わない場合やデータのローミング機能を無効にする場合、ユーザーは引き続きアプリを使用できますが、アプリデータは各デバイスに対してローカルのままになります。

PasswordVault に格納されているデータは、ユーザーが "信頼" しているデバイスにしか移行されません。デバイスが信頼されていない場合、このコンテナーでセキュリティ保護されたデータはローミングされません。

競合の解決

ローミングアプリデータは、一度に複数のデバイスで同時に使用することを目的としたものではありません。特定のデータユニットが 2 つのデバイスで変更されたために同期中に競合が発生した場合、システムは常に最後に書き込まれた値を優先します。これにより、アプリが最新の情報を利用できるようになります。データユニットが設定コンポジットの場合でも、競合解決は設定ユニットのレベルで発生します。これは、最新の変更を含むコンポジットが同期されることを意味します。

データを書き込む場合

設定の予想される有効期間に応じて、異なる時刻にデータを書き込む必要があります。変更頻度が低いアプリデータや緩やかに変化するアプリデータは、すぐに書き込む必要があります。ただし、頻繁に変更されるアプリデータは、定期的な間隔 (5 分に 1 回など) と、アプリが中断されたときにのみ書き込む必要があります。たとえば、音楽アプリでは、"現在の曲" の設定は新しい曲の再生が始まるたびに書き込みますが、曲の途中の実際の位置は中断したときにのみ書き込みます。

過剰な使用保護

システムには、リソースの不適切な使用を回避するためのさまざまな保護メカニズムが用意されています。アプリデータが想定どおりに遷移しない場合は、デバイスが一時的に制限されている可能性があります。しばらく待つと、通常、この状況は自動的に解決され、アクションは必要ありません。

バージョン管理

アプリデータでは、バージョン管理を利用して、あるデータ構造から別のデータ構造にアップグレードできます。バージョン番号はアプリのバージョンとは異なり、必要に応じて設定できます。強制ではありませんが、新しいデータを表すより低いデータバージョン番号に移行しようとすると、望ましくない複雑な問題 (データ損失を含む) が発生する可能性があるため、増加するバージョン番号を使用することを強くお勧めします。

アプリデータは、同じバージョン番号のインストール済みアプリ間でのみローミングされます。たとえば、バージョン 2 のデバイスは相互にデータを切り替え、バージョン 3 のデバイスは同じように動作しますが、バージョン 2 を実行しているデバイスとバージョン 3 を実行しているデバイスの間でローミングは行われません。さまざまなバージョン番号を使用した新しいアプリを他のデバイスにインストールすると、新しくインストールされたアプリは、最も高いバージョン番号に関連付けられているアプリデータを同期します。

テストとツール

開発者は、ローミングアプリデータの同期をトリガーするためにデバイスをロックできます。特定の期間内にアプリデータが遷移しない場合は、次の項目をチェックし、次の点を確認してください。

ローミングデータは最大サイズを超えていません (詳細については、「RoamingStorageQuota」を参照してください)。
ファイルは閉じられ、正しくリリースされました。
同じバージョンのアプリを実行しているデバイスが少なくとも 2 つあります。

ローミングデータが変更されたときに通知を受信するように登録する

ローミングアプリデータを使用するには、ローミングデータの変更に登録し、ローミングデータコンテナーを取得して、設定の読み取りと書き込みを行う必要があります。

ローミングデータが変更されたときに通知を受信するように登録します。

DataChanged イベントは、ローミングデータが変更されたときに通知します。次の使用例は、ローミングデータ変更のハンドラーとして DataChangeHandler を設定します。

void InitHandlers()
    {
       Windows.Storage.ApplicationData.Current.DataChanged += 
          new TypedEventHandler<ApplicationData, object>(DataChangeHandler);
    }

    void DataChangeHandler(Windows.Storage.ApplicationData appData, object o)
    {
       // TODO: Refresh your data
    }

アプリの設定とファイルのコンテナーを取得します。

ApplicationData.Roaming 設定プロパティを使用して設定を取得し、ApplicationData.RoamingFolder プロパティを使用してファイルを取得します。

Windows.Storage.ApplicationDataContainer roamingSettings = 
        Windows.Storage.ApplicationData.Current.RoamingSettings;
    Windows.Storage.StorageFolder roamingFolder = 
        Windows.Storage.ApplicationData.Current.RoamingFolder;

ローミング設定の作成と取得

ApplicationDataContainer.Values プロパティを使用して、前のセクションで取得した roamingSettings コンテナーの設定にアクセスします。この例では、exampleSetting と名付けられた単一の設定と、composite と名付られた複合値を作成します。

// Simple setting

roamingSettings.Values["exampleSetting"] = "Hello World";
// High Priority setting, for example, last page position in book reader app
roamingSettings.values["HighPriority"] = "65";

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
    new Windows.Storage.ApplicationDataCompositeValue();
composite["intVal"] = 1;
composite["strVal"] = "string";

roamingSettings.Values["exampleCompositeSetting"] = composite;

この例では、先ほど作成した設定を取得します。

// Simple setting

Object value = roamingSettings.Values["exampleSetting"];

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
   (Windows.Storage.ApplicationDataCompositeValue)roamingSettings.Values["exampleCompositeSetting"];

if (composite == null)
{
   // No data
}
else
{
   // Access data in composite["intVal"] and composite["strVal"]
}

ローミングファイルの作成と取得

ローミングアプリデータストアでファイルを作成および更新するには、Windows.Storage.StorageFolder.CreateFileAsync や Windows.Storage.FileIO.WriteTextAsync などのファイル API を使用します。この例では、roamingFolder コンテナーの dataFile.txt と名付けられたファイルを作成し、現在の日付と時刻をファイルに書き込みます。 CreationCollisionOption 列挙の ReplaceExisting 値は、ファイルが既に存在する場合は置き換えることを示します。

async void WriteTimestamp()
{
   Windows.Globalization.DateTimeFormatting.DateTimeFormatter formatter = 
       new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");

   StorageFile sampleFile = await roamingFolder.CreateFileAsync("dataFile.txt", 
       CreationCollisionOption.ReplaceExisting);
   await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTimeOffset.Now));
}

ローミングアプリデータストアでファイルを開いて読み取るには、Windows.Storage.StorageFolder.GetFileAsync、Windows.Storage.StorageFile.GetFileFromApplicationUriAsync、Windows.Storage.FileIO.ReadTextAsync などのファイル API を使用します。次の使用例は、前のセクションで作成した dataFile.txt ファイルを開き、そのファイルから日付を読み取ります。さまざまな場所からファイルリソースを読み込む方法の詳細については、「ファイルリソースを読み込む方法」を参照してください。

async void ReadTimestamp()
{
   try
   {
      StorageFile sampleFile = await roamingFolder.GetFileAsync("dataFile.txt");
      String timestamp = await FileIO.ReadTextAsync(sampleFile);
      // Data is contained in timestamp
   }
   catch (Exception)
   {
      // Timestamp not found
   }
}

一時的なアプリデータ

一時アプリデータストアはキャッシュと同様に機能します。そのファイルはローミングされず、いつでも削除できます。システムメンテナンスタスクは、この場所に保存されているデータをいつでも自動的に削除できます。ユーザーは、ディスククリーンアップを使用して一時データストアからファイルをクリアすることもできます。一時的なアプリデータは、アプリセッション中に一時的な情報を格納するために使用できます。必要に応じて、システムが使用領域を再利用する可能性があるため、このデータがアプリセッションの終了を超えて保持される保証はありません。この場所は temporaryFolder プロパティを使用して使用できます。

一時データコンテナーを取得する

ApplicationData.TemporaryFolder プロパティを使用してファイルを取得します。次の手順では、この手順の temporaryFolder 変数を使用します。

Windows.Storage.StorageFolder temporaryFolder = ApplicationData.Current.TemporaryFolder;

一時ファイルの作成と読み取り

一時アプリデータストアでファイルを作成して更新するには、Windows.Storage.StorageFolder.CreateFileAsync や Windows.Storage.FileIO.WriteTextAsync などのファイル API を使用します。この例では、temporaryFolder コンテナーの dataFile.txt と名付けられたファイルを作成し、現在の日付と時刻をファイルに書き込みます。 CreationCollisionOption 列挙の ReplaceExisting 値は、ファイルが既に存在する場合は置き換えることを示します。

async void WriteTimestamp()
{
   Windows.Globalization.DateTimeFormatting.DateTimeFormatter formatter = 
       new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");

   StorageFile sampleFile = await temporaryFolder.CreateFileAsync("dataFile.txt", 
       CreateCollisionOption.ReplaceExisting);
   await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTimeOffset.Now));
}

一時アプリデータストアでファイルを開いて読み取るには、Windows.Storage.StorageFolder.GetFileAsync、Windows.Storage.StorageFile.GetFileFromApplicationUriAsync、Windows.Storage.FileIO.ReadTextAsync などのファイル API を使用します。次の使用例は、前の手順で作成した dataFile.txt ファイルを開き、そのファイルから日付を読み取ります。さまざまな場所からファイルリソースを読み込む方法の詳細については、「ファイルリソースを読み込む方法」を参照してください。

async void ReadTimestamp()
{
   try
   {
      StorageFile sampleFile = await temporaryFolder.GetFileAsync("dataFile.txt");
      String timestamp = await FileIO.ReadTextAsync(sampleFile);
      // Data is contained in timestamp
   }
   catch (Exception)
   {
      // Timestamp not found
   }
}

コンテナーを使用してアプリデータを整理する

アプリのデータ設定とファイルを整理するために、ディレクトリを直接操作するのではなく、コンテナー (ApplicationDataContainer オブジェクトで表されます) を作成します。コンテナーは、ローカル、ローミング、および一時的なアプリデータストアに追加できます。コンテナーは、最大 32 レベルの深さまで入れ子にすることができます。

設定コンテナーを作成するには、ApplicationDataContainer.CreateContainer メソッドを呼び出します。この例では、exampleContainer という名前のローカル設定コンテナーを作成し、exampleSetting という名前の設定を追加します。 ApplicationDataCreateDisposition 列挙体の Always 値は、コンテナーがまだ存在しない場合に作成されることを示します。

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Setting in a container
Windows.Storage.ApplicationDataContainer container = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.Containers.ContainsKey("exampleContainer"))
{
   localSettings.Containers["exampleContainer"].Values["exampleSetting"] = "Hello Windows";
}

アプリの設定とコンテナーを削除する

アプリに不要になった単純な設定を削除するには、ApplicationDataContainer Settings.Remove メソッドを使用します。次の使用例は、先ほど作成した exampleSetting ローカル設定を削除します。

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Delete simple setting

localSettings.Values.Remove("exampleSetting");

複合設定を削除するには、ApplicationDataCompositeValue.Remove メソッドを使用します。次の使用例は、前の例で作成したローカル exampleCompositeSetting 複合設定を削除します。

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Delete composite setting

localSettings.Values.Remove("exampleCompositeSetting");

コンテナーを削除するには、ApplicationDataContainer.DeleteContainer メソッドを呼び出します。次の使用例は、先ほど作成したローカル exampleContainer 設定コンテナーを削除します。

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Delete container

localSettings.DeleteContainer("exampleContainer");

アプリデータのバージョン管理

必要に応じて、アプリのアプリデータのバージョンを設定できます。これにより、以前のバージョンのアプリとの互換性の問題を引き起こすことなく、アプリデータの形式を変更する将来のバージョンのアプリを作成できます。アプリはデータストア内のアプリデータのバージョンをチェックし、バージョンがアプリで想定されているバージョンより小さい場合、アプリはアプリデータを新しい形式に更新し、バージョンを更新する必要があります。詳細については、Application.Version プロパティと ApplicationData.SetVersionAsync メソッドを参照してください。

次の方法で共有

設定と他のアプリデータを保存して取得する

アプリデータの種類

設定

ファイル

アプリデータストアにアプリデータを格納する

ローカルアプリデータ

ローカルアプリデータストアを取得する

簡単なローカル設定を作成して取得する

ローカル複合値を作成して取得する

ローカルファイルの作成および読み取り

データをローミング

ローミングデータですべきこととしてはいけないこと

ローミングの前提条件

競合の解決

データを書き込む場合

過剰な使用保護

バージョン管理

テストとツール

ローミングデータが変更されたときに通知を受信するように登録する

ローミング設定の作成と取得

ローミングファイルの作成と取得

一時的なアプリデータ

一時データコンテナーを取得する

一時ファイルの作成と読み取り

コンテナーを使用してアプリデータを整理する

アプリの設定とコンテナーを削除する

アプリデータのバージョン管理

その他のリソース

次の方法で共有

設定と他のアプリ データを保存して取得する

アプリ データの種類

設定

ファイル

アプリ データ ストアにアプリ データを格納する

ローカル アプリ データ

ローカル アプリ データ ストアを取得する

簡単なローカル設定を作成して取得する

ローカル複合値を作成して取得する

ローカル ファイルの作成および読み取り

データをローミング

ローミング データですべきこととしてはいけないこと

ローミングの前提条件

競合の解決

データを書き込む場合

過剰な使用保護

バージョン管理

テストとツール

ローミング データが変更されたときに通知を受信するように登録する

ローミング設定の作成と取得

ローミング ファイルの作成と取得

一時的なアプリ データ

一時データ コンテナーを取得する

一時ファイルの作成と読み取り

コンテナーを使用してアプリ データを整理する

アプリの設定とコンテナーを削除する

アプリ データのバージョン管理

関連記事

その他のリソース

設定と他のアプリデータを保存して取得する

アプリデータの種類

アプリデータストアにアプリデータを格納する

ローカルアプリデータ

ローカルアプリデータストアを取得する

ローカルファイルの作成および読み取り

ローミングデータですべきこととしてはいけないこと

ローミングデータが変更されたときに通知を受信するように登録する

ローミングファイルの作成と取得

一時的なアプリデータ

一時データコンテナーを取得する

コンテナーを使用してアプリデータを整理する

アプリデータのバージョン管理