DesignerSerializationManager.RecycleInstances Proprietà

Definizione

Spazio dei nomi:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

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à

Boolean

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

InvalidOperationException

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.

Vedi anche

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