DesignerSerializationManager.RecycleInstances Właściwość

Definicja

Przestrzeń nazw:

System.ComponentModel.Design.Serialization

Zestaw:

System.Windows.Forms.Design.dll

Pobiera lub ustawia wartość wskazującą, czy CreateInstance(Type, ICollection, String, Boolean) zawsze utworzy nowe wystąpienie typu.

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

Wartość właściwości

Boolean

true jeśli CreateInstance(Type, ICollection, String, Boolean) zwróci istniejące wystąpienie; false jeśli CreateInstance(Type, ICollection, String, Boolean) utworzy nowe wystąpienie typu. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Menedżer serializacji ma aktywną sesję serializacji.

Uwagi

RecycleInstances Jeśli właściwość to false, CreateInstance metoda zawsze utworzy nowe wystąpienie typu. Jeśli RecycleInstances jest to true, CreateInstance najpierw przeszuka tabelę nazw i kontener dla obiektu o tej samej nazwie. Jeśli taki obiekt istnieje i jest tego samego typu, CreateInstance zwróci istniejące wystąpienie. Ta druga odmiana jest przydatna do implementowania serializatora, który stosuje stan serializacji do istniejącego zestawu obiektów, a nie zawsze tworzenia nowego drzewa. Polecenie Cofnij często używa tego typu serializatora.

W przypadku, gdy RecycleInstances właściwość to true, ValidateRecycledTypes właściwość będzie dalej modyfikować zachowanie CreateInstance w zależności od typów dwóch obiektów.

Zobacz też

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