Прочитать на английском

Поделиться через


ApplicationDataContainer Класс

Определение

Представляет контейнер для параметров приложения. Методы и свойства этого класса поддерживают создание, удаление, перечисление и обход иерархии контейнеров.

[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
Наследование
Object ApplicationDataContainer
Атрибуты
Реализации

Требования к 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");

Комментарии

Примечание

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

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

Свойства

Containers

Возвращает дочерние контейнеры параметров приложения для этого контейнера параметров приложения.

Locality

Возвращает тип (локальный или перемещаемый) хранилища данных приложения, связанного с текущим контейнером параметров.

Name

Возвращает имя текущего контейнера параметров.

Values

Возвращает объект , представляющий параметры в этом контейнере параметров.

Методы

Close()

Примечание

Этот элемент не реализован в C#.

CreateContainer(String, ApplicationDataCreateDisposition)

Создает или открывает указанный контейнер параметров в текущем контейнере параметров.

DeleteContainer(String)

Удаляет указанный контейнер параметров, его подконтейнеры и все параметры приложения в иерархии.

Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

Применяется к

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