DesignerSerializationManager.PreserveNames Propriété

Définition

Espace de noms:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

Obtient ou définit une valeur qui indique si la méthode CreateInstance(Type, ICollection, String, Boolean) doit vérifier la présence du nom donné dans le conteneur.

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

Valeur de propriété

Boolean

true si CreateInstance(Type, ICollection, String, Boolean) passe le nom du composant donné ; false si CreateInstance(Type, ICollection, String, Boolean) vérifie la présence du nom donné dans le conteneur. La valeur par défaut est true.

Exceptions

InvalidOperationException

Cette propriété a été changée à partir d'une session de sérialisation.

Remarques

La PreserveNames propriété détermine le comportement de la CreateInstance méthode. Si true, CreateInstance transmet le nom de composant donné. Si false, CreateInstance case activée pour la présence du nom donné dans le conteneur. Si le nom n’existe pas dans le conteneur, CreateInstance utilise le nom donné. Si le nom existe dans le conteneur, CreateInstance transmet une valeur null comme nom d’un composant lors de son ajout au conteneur, ce qui lui donne un nouveau nom. Cette deuxième variante est utile pour implémenter un sérialiseur qui duplique toujours des objets, plutôt que de supposer que ces objets n’existent pas. Les commandes coller utilisent souvent ce type de sérialiseur.

Vous pouvez uniquement modifier cette propriété lorsque vous n’êtes pas dans une session de sérialisation.

Voir aussi

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