LocalFileSettingsProvider.SetPropertyValues Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает значения указанной группы параметров свойств.
public:
override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unitPublic Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)Параметры
- context
- SettingsContext
Объект SettingsContext, описывающий текущее использование приложения.
Объект SettingsPropertyValueCollection, представляющий группу параметров свойств, которые необходимо задать.
Исключения
Был обнаружен параметр на уровне пользователя, но текущая конфигурация поддерживает только параметры на уровне приложения.
-или-
Произошла общая ошибка при сохранении параметров в файле конфигурации.
Комментарии
Класс-оболочка settings, производный от ApplicationSettingsBase, содержит Save метод , который вызывается для сохранения значений всех его свойств параметров. Этот метод перечисляет все поставщики параметров, связанные со свойствами параметров, и вызывает SetPropertyValues метод для каждого из них SettingsProvider для выполнения фактической операции сериализации.
SetPropertyValues по отдельности сериализует каждое свойство параметров приложения на уровне пользователя в соответствующий параметр приложения в соответствующем user.config файле конфигурации.
По умолчанию SetPropertyValues метод использует следующую логическую последовательность для определения схемы сериализации в зависимости от типа свойства settings:
Если тип связан TypeConverter с реализацией ConvertToString метода, используется это преобразование.
Используется XML-сериализация.
Однако можно указать предпочтительный механизм сериализации с помощью SettingsSerializeAsAttribute. LocalFileSettingsProvider не поддерживает двоичную сериализацию в Visual Studio 2005.
Если для свойства параметров на уровне пользователя явно задано значение по умолчанию, то поставщик параметров локального файла удалит запись для связанного параметра из файла конфигурации пользователя. Следующий доступ на чтение для этого свойства будет просто использовать значение по умолчанию.
Внимание!
LocalFileSettingsProvider не использует шифрование для сохранения параметров. Поэтому не храните пароли в виде обычного текста или другую конфиденциальную информацию с помощью этого поставщика без дополнительных мер предосторожности, таких как отдельное шифрование информации в файле конфигурации. Дополнительные сведения см. в разделе Шифрование сведений о конфигурации с помощью защищенной конфигурации.
