ApplicationDataContainer Kelas

Definisi

Ruang nama:

Windows.Storage

Mewakili kontainer untuk pengaturan aplikasi. Metode dan properti kelas ini mendukung pembuatan, penghapusan, enumerasi, dan melintasi hierarki kontainer.

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

Warisan

Object Platform::Object IInspectable ApplicationDataContainer

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan

IClosable IDisposable

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Panggil metode ApplicationDataContainer.CreateContainer untuk membuat kontainer pengaturan, atau untuk mengembalikan kontainer yang ada. Contoh ini membuat kontainer pengaturan bernama exampleContainer dan menambahkan pengaturan bernama exampleSetting. Nilai Always dari enumerasi ApplicationDataCreateDisposition menunjukkan bahwa kontainer harus dibuat jika belum ada.

Gunakan properti ApplicationDataContainer.Values untuk mengakses exampleSetting pengaturan dalam exampleContainer kontainer.

Panggil metode ApplicationDataContainer.DeleteContainer untuk menghapus exampleContainer kontainer pengaturan setelah Anda selesai menggunakannya.

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")

Keterangan

Catatan

Tidak ada kontainer pengaturan untuk penyimpanan data aplikasi sementara.

Properti Nilai mendapatkan objek ApplicationDataContainerSettings yang menyediakan akses ke pengaturan yang disimpan dalam kontainer.

Properti

Containers	Mendapatkan kontainer pengaturan aplikasi anak dari kontainer pengaturan aplikasi ini.
Locality	Mendapatkan jenis (lokal atau roaming) penyimpanan data aplikasi yang terkait dengan kontainer pengaturan saat ini.
Name	Mendapatkan nama kontainer pengaturan saat ini.
Values	Mendapatkan objek yang mewakili pengaturan dalam kontainer pengaturan ini.

Metode

Close()	Catatan Anggota ini tidak diimplementasikan dalam C#.
CreateContainer(String, ApplicationDataCreateDisposition)	Membuat atau membuka kontainer pengaturan yang ditentukan dalam kontainer pengaturan saat ini.
DeleteContainer(String)	Menghapus kontainer pengaturan yang ditentukan, subkontainernya, dan semua pengaturan aplikasi dalam hierarki.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.

Lihat juga

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Menyimpan dan mengambil pengaturan dan data aplikasi lainnya
• Sampel data aplikasi