DesignerSerializationManager.PreserveNames 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 il metodo CreateInstance(Type, ICollection, String, Boolean) deve verificare la presenza del nome dato nel contenitore.
public:
property bool PreserveNames { bool get(); void set(bool value); };
public bool PreserveNames { get; set; }
member this.PreserveNames : bool with get, set
Public Property PreserveNames As Boolean
Valore della proprietà
true
se CreateInstance(Type, ICollection, String, Boolean) passerà il nome del componente dato; false
se CreateInstance(Type, ICollection, String, Boolean) verificherà la presenza del nome dato nel contenitore. Il valore predefinito è true
.
Eccezioni
Questa proprietà è stata modificata dall'interno di una sessione di serializzazione.
Commenti
La PreserveNames proprietà determina il comportamento del CreateInstance metodo . Se true
, CreateInstance passerà il nome del componente specificato. Se false
, CreateInstance verificherà la presenza del nome specificato nel contenitore. Se il nome non esiste nel contenitore, CreateInstance userà il nome specificato. Se il nome esiste nel contenitore, CreateInstance passerà un valore Null come nome di un componente durante l'aggiunta al contenitore, assegnando così un nuovo nome. Questa seconda variante è utile per implementare un serializzatore che duplica sempre gli oggetti, invece di presupporre che tali oggetti non esistano. I comandi Incolla usano spesso questo tipo di serializzatore.
È possibile modificare questa proprietà solo quando non si è in una sessione di serializzazione.