ApplicationDataContainer クラス

定義

名前空間:

Windows.Storage

アプリ設定のコンテナーを表します。 このクラスのメソッドとプロパティは、コンテナー階層の作成、削除、列挙、および走査をサポートします。

public ref class ApplicationDataContainer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ApplicationDataContainer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ApplicationDataContainer : System.IDisposable

Public NotInheritable Class ApplicationDataContainer
Implements IDisposable

継承

Object Platform::Object IInspectable ApplicationDataContainer

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

IClosable IDisposable

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

ApplicationDataContainer.CreateContainer メソッドを呼び出して設定コンテナーを作成するか、既存のコンテナーを返します。 この例では、 という名前の設定コンテナーを作成し、 という exampleContainer 名前 exampleSettingの設定を追加します。 ApplicationDataCreateDisposition 列挙の Always 値は、コンテナーがまだ存在しない場合は作成する必要があることを示します。

ApplicationDataContainer.Values プロパティを使用して、コンテナー内のexampleSetting設定にexampleContainerアクセスします。

ApplicationDataContainer.DeleteContainer メソッドを呼び出して、設定コンテナーを終了したら削除exampleContainerします。

Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;

// Create a 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!";
}

// Read data from a setting in a container

bool hasContainer = localSettings.Containers.ContainsKey("exampleContainer");
bool hasSetting = false;

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

// Delete a container

localSettings.DeleteContainer("exampleContainer");

Windows::Storage::ApplicationDataContainer localSettings{
    Windows::Storage::ApplicationData::Current().LocalSettings() };

// Create a setting in a container.
Windows::Storage::ApplicationDataContainer container{
    localSettings.CreateContainer(L"exampleContainer", Windows::Storage::ApplicationDataCreateDisposition::Always) };

if (localSettings.Containers().HasKey(L"exampleContainer"))
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    values.Insert(L"exampleSetting", winrt::box_value(L"Hello, Windows!"));
}

// Read data from a setting in a container.
bool hasContainer{ localSettings.Containers().HasKey(L"exampleContainer") };
bool hasSetting{ false };

if (hasContainer)
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    hasSetting = values.HasKey(L"exampleSetting");
}

// Delete a container.
localSettings.DeleteContainer(L"exampleContainer");

ApplicationDataContainer^ localSettings = ApplicationData::Current->LocalSettings;

// Create a setting in a container

ApplicationDataContainer^ container = 
   localSettings->CreateContainer("exampleContainer", ApplicationDataCreateDisposition::Always);

if (localSettings->Containers->HasKey("exampleContainer"))
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   values->Insert("exampleSetting", "Hello, Windows!");
}

// Read data from a setting in a container

bool hasContainer = localSettings->Containers->HasKey("exampleContainer");
bool hasSetting = false;

if (hasContainer)
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   hasSetting = values->HasKey("exampleSetting");
}

// Delete a container

localSettings->DeleteContainer("exampleContainer");

Dim localSettings As Windows.Storage.ApplicationDataContainer = Windows.Storage.ApplicationData.Current.LocalSettings

' Create a setting in a container

Dim container As Windows.Storage.ApplicationDataContainer = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always)

If localSettings.Containers.ContainsKey("exampleContainer") Then
    localSettings.Containers("exampleContainer").Values("exampleSetting") = "Hello, Windows!"
End If

' Read data from a setting in a container

Dim hasContainer As Boolean = localSettings.Containers.ContainsKey("exampleContainer")
Dim hasSetting As Boolean = False

If hasContainer Then
    hasSetting = localSettings.Containers("exampleContainer").Values.ContainsKey("exampleSetting")
End If

' Delete a container

localSettings.DeleteContainer("exampleContainer")

注釈

Note

一時アプリ データ ストアの設定コンテナーはありません。

Values プロパティは、コンテナーに格納されている設定へのアクセスを提供する ApplicationDataContainerSettings オブジェクトを取得します。

プロパティ

Containers	このアプリケーション設定コンテナーの子アプリケーション設定コンテナーを取得します。
Locality	現在の設定コンテナーに関連付けられているアプリ データ ストアの型 (ローカルまたはローミング) を取得します。
Name	現在の設定コンテナーの名前を取得します。
Values	この設定コンテナーの設定を表す オブジェクトを取得します。

メソッド

Close()	Note このメンバーは C# では実装されていません。
CreateContainer(String, ApplicationDataCreateDisposition)	現在の設定コンテナーで、指定した設定コンテナーを作成または開きます。
DeleteContainer(String)	指定した設定コンテナー、そのサブコンテナー、階層内のすべてのアプリケーション設定を削除します。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

こちらもご覧ください

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• 設定と他のアプリ データを保存して取得する
• アプリケーション データ サンプル