PropertyDescriptor.ShouldSerializeValue(Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе определяет значение, показывающее, нужно ли сохранить данное значение свойства.
public:
abstract bool ShouldSerializeValue(System::Object ^ component);public abstract bool ShouldSerializeValue (object component);abstract member ShouldSerializeValue : obj -> boolPublic MustOverride Function ShouldSerializeValue (component As Object) As BooleanПараметры
- component
- Object
Компонент со свойством, возможность сохранения которого нужно проверить.
Возвращаемое значение
Значение true, если свойство следует сохранить; в противном случае — значение false.
Комментарии
Как правило, этот метод реализуется с помощью отражения.
Примечания для тех, кто реализует этот метод
При переопределении в производном классе этот метод возвращает true значение , если текущее значение свойства отличается от значения по умолчанию. Он ищет значение по умолчанию путем первого поиска DefaultValueAttribute. Если метод находит этот атрибут, он сравнивает значение атрибута с текущим значением свойства. Если этот метод не может найти DefaultValueAttribute, он ищет метод "ShouldSerializeMyProperty", который необходимо реализовать. Если он найден, ShouldSerializeValue(Object) вызывает его. Если этому методу DefaultValueAttribute не удается найти метод или "ShouldSerializeMyProperty", он не сможет создать оптимизации и возвращает .true
Примечание. Класс ComponentDesigner реализует специальную логику сериализации для унаследованных компонентов. Для получения дополнительной информации см. ComponentDesigner.
