DesignerSerializationManager.RecycleInstances Свойство

Определение

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

System.ComponentModel.Design.Serialization

Сборка:

System.Windows.Forms.Design.dll

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

DesignerSerializationManager.cs

Возвращает или задает значение, указывающее, будет ли 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Значение , если будет возвращен существующий экземпляр; false если CreateInstance(Type, ICollection, String, Boolean)CreateInstance(Type, ICollection, String, Boolean) будет создан новый экземпляр типа. Значение по умолчанию — false.

Исключения

InvalidOperationException

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

Комментарии

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

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

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

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