DesignerSerializationManager.RecycleInstances Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение для обозначения, будет ли метод CreateInstance(Type, ICollection, String, Boolean) всегда создавать новый экземпляр типа.
public:
property bool RecycleInstances { bool get(); void set(bool value); };
public bool RecycleInstances { get; set; }
member this.RecycleInstances : bool with get, set
Public Property RecycleInstances As Boolean
Значение свойства
Значение true
, если метод CreateInstance(Type, ICollection, String, Boolean) возвращает существующий экземпляр; значение false
, если метод CreateInstance(Type, ICollection, String, Boolean) создает новый экземпляр типа. Значение по умолчанию — false
.
Исключения
Диспетчер сериализации в активном сеансе сериализации.
Комментарии
RecycleInstances Если свойство имеет значение false
, CreateInstance метод всегда создает новый экземпляр типа . Если RecycleInstances имеет значение true
, CreateInstance сначала выполняет поиск в таблице имен и контейнере для объекта с тем же именем. Если такой объект существует и имеет тот же тип, CreateInstance возвращает существующий экземпляр . Этот второй вариант полезен для реализации сериализатора, который применяет состояние сериализации к существующему набору объектов, а не всегда создает новое дерево. Команда Undo часто использует этот тип сериализатора.
В случае, когда RecycleInstances свойство имеет значение true
, ValidateRecycledTypes свойство дополнительно изменяет поведение CreateInstance в зависимости от типов двух объектов.