DesignerSerializationManager.RecycleInstances Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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
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.