LocalFileSettingsProvider.SetPropertyValues Метод

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

LocalFileSettingsProvider.cs

Задает значения указанной группы параметров свойств.

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 -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Параметры

context

SettingsContext

Объект SettingsContext, описывающий текущее использование приложения.

values

SettingsPropertyValueCollection

Объект SettingsPropertyValueCollection, представляющий группу параметров свойств, которые необходимо задать.

Исключения

ConfigurationErrorsException

Был обнаружен параметр на уровне пользователя, но текущая конфигурация поддерживает только параметры на уровне приложения.

-или-

Произошла общая ошибка при сохранении параметров в файле конфигурации.

Комментарии

Класс-оболочка settings, производный от ApplicationSettingsBase, содержит Save метод , который вызывается для сохранения значений всех его свойств параметров. Этот метод перечисляет все поставщики параметров, связанные со свойствами параметров, и вызывает SetPropertyValues метод для каждого из них SettingsProvider для выполнения фактической операции сериализации.

SetPropertyValues по отдельности сериализует каждое свойство параметров приложения на уровне пользователя в соответствующий параметр приложения в соответствующем user.config файле конфигурации.

По умолчанию SetPropertyValues метод использует следующую логическую последовательность для определения схемы сериализации в зависимости от типа свойства settings:

1. Если тип связан TypeConverter с реализацией ConvertToString метода, используется это преобразование.

2. Используется XML-сериализация.

Однако можно указать предпочтительный механизм сериализации с помощью SettingsSerializeAsAttribute. LocalFileSettingsProvider не поддерживает двоичную сериализацию в Visual Studio 2005.

Если для свойства параметров на уровне пользователя явно задано значение по умолчанию, то поставщик параметров локального файла удалит запись для связанного параметра из файла конфигурации пользователя. Следующий доступ на чтение для этого свойства будет просто использовать значение по умолчанию.

Внимание!

LocalFileSettingsProvider не использует шифрование для сохранения параметров. Поэтому не храните пароли в виде обычного текста или другую конфиденциальную информацию с помощью этого поставщика без дополнительных мер предосторожности, таких как отдельное шифрование информации в файле конфигурации. Дополнительные сведения см. в разделе Шифрование сведений о конфигурации с помощью защищенной конфигурации.

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

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute