DesignerSerializationManager.RecycleInstances Свойство

Определение

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

System.ComponentModel.Design.Serialization

Сборка:

System.Windows.Forms.Design.dll

Получает или задает значение для обозначения, будет ли метод 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

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

Boolean

Значение true, если метод CreateInstance(Type, ICollection, String, Boolean) возвращает существующий экземпляр; значение false, если метод CreateInstance(Type, ICollection, String, Boolean) создает новый экземпляр типа. Значение по умолчанию — false.

Исключения

InvalidOperationException

Диспетчер сериализации в активном сеансе сериализации.

Комментарии

RecycleInstances Если свойство имеет значение false, CreateInstance метод всегда создает новый экземпляр типа . Если RecycleInstances имеет значение true, CreateInstance сначала выполняет поиск в таблице имен и контейнере для объекта с тем же именем. Если такой объект существует и имеет тот же тип, CreateInstance возвращает существующий экземпляр . Этот второй вариант полезен для реализации сериализатора, который применяет состояние сериализации к существующему набору объектов, а не всегда создает новое дерево. Команда Undo часто использует этот тип сериализатора.

В случае, когда RecycleInstances свойство имеет значение true, ValidateRecycledTypes свойство дополнительно изменяет поведение CreateInstance в зависимости от типов двух объектов.

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

• CreateInstance(Type, ICollection, String, Boolean)
• ValidateRecycledTypes