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. Значение Always из перечисления ApplicationDataCreateDisposition указывает, что контейнер необходимо создать, если он еще не существует.

Используйте свойство 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")

Комментарии

Примечание

Контейнер параметров для временного хранилища данных приложения отсутствует.

Свойство Values получает объект ApplicationDataContainerSettings , который предоставляет доступ к параметрам, хранящимся в контейнере.

Свойства

Containers	Возвращает дочерние контейнеры параметров приложения для этого контейнера параметров приложения.
Locality	Возвращает тип (локальный или перемещаемый) хранилища данных приложения, связанного с текущим контейнером параметров.
Name	Возвращает имя текущего контейнера параметров.
Values	Возвращает объект , представляющий параметры в этом контейнере параметров.

Методы

Close()	Примечание Этот элемент не реализован в C#.
CreateContainer(String, ApplicationDataCreateDisposition)	Создает или открывает указанный контейнер параметров в текущем контейнере параметров.
DeleteContainer(String)	Удаляет указанный контейнер параметров, его подконтейнеры и все параметры приложения в иерархии.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

См. также раздел

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Хранение и извлечение параметров и прочих данных приложения
• Пример данных приложения