SettingsPropertyValue.PropertyValue Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение объекта 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
Значение свойства
Значение объекта 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.
Исключения
Произошла ошибка при попытке использовать значение по умолчанию из свойства DefaultValue. Либо потерпела неудачу попытка преобразовать свойство DefaultValue в законный тип, или результирующее значение оказалось несовместимым с типом определенным PropertyType.