SettingsPropertyValue.PropertyValue Свойство

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

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

SettingsPropertyValue.cs

Возвращает или задает значение объекта SettingsProperty.

public:
 property System::Object ^ PropertyValue { System::Object ^ get(); void set(System::Object ^ value); };

public object PropertyValue { get; set; }

member this.PropertyValue : obj with get, set

Public Property PropertyValue As Object

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

Object

Значение объекта SettingsProperty. Когда значение устанавливается, свойство IsDirty устанавливается в true и UsingDefaultValue устанавливается в false.

Когда в первый раз к значению производится доступ из свойства PropertyValue, и если значение изначально хранилось в объекте SettingsPropertyValue как сериализованное представление, используя свойство SerializedValue, то свойство PropertyValue инициирует десериализацию лежащего в основе значения. Как побочный эффект, свойство Deserialized будет установлено в true.

Если эта цепочка событий происходит в ASP.NET, и если ошибка случается в процессе десериализации, то ошибка заносится в журнал, используя средства мониторинга состояния оборудования ASP.NET. По умолчанию, это означает, что ошибки десериализации будут показываться в Журнале событий приложения при работе под ASP.NET. Если этот процесс происходит вне ASP.NET, и если ошибка случается во время десериализации, то ошибка подавляется, и реализуется оставшаяся часть процесса десериализации. Если нет сериализованных значений для десериализации при попытке выполнения десериализации, то объект SettingsPropertyValue попытается вернуться к значению по умолчанию, если оно было сконфигурировано согласно определению на связанном экземпляре SettingsProperty. В этом случае, если свойство DefaultValue установлено либо в null, либо в строку [null], то объект SettingsPropertyValue будет инициализировать свойство PropertyValue либо в null для ссылочных типов, либо в значение по умолчанию для ассоциированного типа значения. С другой стороны, если свойство DefaultValue содержит законную ссылку на объект или строковое значение (отличное от "[null]"), то взамен возвращается свойство DefaultValue.

Если нет сериализованных значений для десериализации при попытке выполнения десериализации, и не определено значение по умолчанию, то для строковых типов будет возвращена пустая строка. Для всех остальных типов экземпляр по умолчанию возвращается путем вызова CreateInstance(Type) . Для ссылочных типов это означает, что будет предпринята попытка создать экземпляр объекта с помощью конструктора без параметров. Если эта попытка терпит неудачу, то возвращается null.

Исключения

ArgumentException

Произошла ошибка при попытке использовать значение по умолчанию из свойства DefaultValue. Либо потерпела неудачу попытка преобразовать свойство DefaultValue в законный тип, или результирующее значение оказалось несовместимым с типом определенным PropertyType.