ApplicationData.RoamingSettings | roamingSettings Property

Получает контейнер параметров приложения в перемещаемом хранилище данных приложения.

Синтаксис


public ApplicationDataContainer RoamingSettings { get; }

Значение свойства

Тип: ApplicationDataContainer

Контейнер параметров приложения.

Замечания

Имя каждого параметра может иметь максимум 255 символов в длину. Каждый параметр может быть размером до 8 тысяч байтов, каждый составной параметр может быть размером до 64 тысяч байтов. Обработчик синхронизации может ограничить общий размер параметров и файлов, которые могут перемещаться.

Для параметров приложения поддерживаются Типы данных среды выполнения Windows.

Windows Phone 8

Этот API не реализован, и в случае его вызова возникнет исключение. См. API среды выполнения Windows Phone.

Примеры

Используйте свойство RoamingSettings | roamingSettings, чтобы получить параметры в объекте ApplicationDataContainer. Используйте свойство ApplicationDataContainer.Values | values, чтобы получить доступ к параметрам в контейнере roamingSettings. В этом примере создается и считывает параметр с именем exampleSetting.

Вызовите метод ApplicationDataContainerSettings.Remove | remove для удаления параметра exampleSetting после завершения работы с ним.


var roamingSettings = Windows.Storage.ApplicationData.Current.RoamingSettings;

// Create a simple setting

roamingSettings.Values["exampleSetting"] = "Hello World";

// Read data from a simple setting

Object value = roamingSettings.Values["exampleSetting"];

if (value == null)
{
    // No data
}
else
{
    // Access data in value
}

// Delete a simple setting

roamingSettings.Values.Remove("exampleSetting");

Требования

Минимальная версия клиента

Windows 8

Минимальная версия сервера

Windows Server 2012

Минимальная версия телефона

Windows Phone 8 [не реализовано, см. раздел "Примечания"]

Пространство имен

Windows.Storage
Windows::Storage [C++]

Метаданные

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

См. также

Задачи
Краткое руководство. Перемещаемые данные приложения (JavaScript)
Краткое руководство. Перемещаемые данные приложения (C#/VB/C++)
Основные понятия
Общие сведения о данных приложения
Ссылка
ApplicationData

 

 

Показ:
© 2014 Microsoft