DesignerSerializationManager.RecycleInstances Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu, která označuje, zda CreateInstance(Type, ICollection, String, Boolean) bude vždy vytvořit novou instanci 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
Hodnota vlastnosti
true
if CreateInstance(Type, ICollection, String, Boolean) vrátí existující instanci; false
if CreateInstance(Type, ICollection, String, Boolean) vytvoří novou instanci typu. Výchozí formát je false
.
Výjimky
Správce serializace má aktivní serializace relace.
Poznámky
RecycleInstances Pokud je false
vlastnost , CreateInstance metoda vždy vytvoří novou instanci typu. Pokud RecycleInstances je true
, CreateInstance vyhledá nejprve v tabulce názvů a kontejneru objekt se stejným názvem. Pokud takový objekt existuje a je stejného typu, CreateInstance vrátí existující instanci. Tato druhá varianta je užitečná pro implementaci serializátoru, který aplikuje stav serializace na existující sadu objektů, nikoli vždy vytvořit nový strom. Příkaz Zpět často používá tento typ serializátoru.
V případě, že RecycleInstances je vlastnost , ValidateRecycledTypes vlastnost dále upraví chování objektu CreateInstance v závislosti na typech true
těchto dvou objektů.