Bagikan melalui


ApplicationDataContainer Kelas

Definisi

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

public ref class ApplicationDataContainer sealed
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
/// [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
[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
Public NotInheritable Class ApplicationDataContainer
Implements IDisposable
Warisan
Object Platform::Object IInspectable ApplicationDataContainer
Atribut
Penerapan

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.

Berlaku untuk

Lihat juga