DesignerSerializationManager.RecycleInstances Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se CreateInstance(Type, ICollection, String, Boolean) creerà sempre una nuova istanza di un tipo.
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
Valore della proprietà
true
se CreateInstance(Type, ICollection, String, Boolean) restituirà l'istanza esistente; false
se CreateInstance(Type, ICollection, String, Boolean) creerà una nuova istanza di un tipo. Il valore predefinito è false
.
Eccezioni
Il gestore della serializzazione presenta una sessione di serializzazione attiva.
Commenti
Se la RecycleInstances proprietà è false
, il CreateInstance metodo creerà sempre una nuova istanza di un tipo. Se RecycleInstances è true
, CreateInstance cerca innanzitutto nella tabella dei nomi e nel contenitore un oggetto con lo stesso nome. Se tale oggetto esiste ed è dello stesso tipo, CreateInstance restituirà l'istanza esistente. Questa seconda variante è utile per implementare un serializzatore che applica lo stato di serializzazione a un set esistente di oggetti, anziché creare sempre un nuovo albero. Il comando Annulla usa spesso questo tipo di serializzatore.
Nel caso in cui la RecycleInstances proprietà sia true
, la ValidateRecycledTypes proprietà modificherà ulteriormente il comportamento di CreateInstance a seconda dei tipi dei due oggetti.