DesignerSerializationManager.RecycleInstances Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui indique si CreateInstance(Type, ICollection, String, Boolean) créera toujours une nouvelle instance d’un type.
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
Valeur de propriété
true
si CreateInstance(Type, ICollection, String, Boolean) retourne l'instance existante ; false
si CreateInstance(Type, ICollection, String, Boolean) crée une nouvelle instance d'un type. La valeur par défaut est false
.
Exceptions
Le gestionnaire de sérialisation dispose d'une session de sérialisation active.
Remarques
Si la propriété a la RecycleInstances valeur false
, la CreateInstance méthode crée toujours une nouvelle instance d’un type. Si RecycleInstances a la valeur true
, CreateInstance recherche d’abord dans la table de noms et le conteneur un objet du même nom. Si un tel objet existe et est du même type, CreateInstance retourne le instance existant. Cette deuxième variante est utile pour implémenter un sérialiseur qui applique l’état de sérialisation à un ensemble d’objets existant, plutôt que de toujours créer une arborescence. La commande Annuler utilise souvent ce type de sérialiseur.
Dans le cas où la propriété a true
la RecycleInstances valeur , la ValidateRecycledTypes propriété modifie davantage le comportement de CreateInstance en fonction des types des deux objets.