DesignerSerializationManager.PreserveNames Propriété

Définition

Espace de noms:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

Source:

DesignerSerializationManager.cs

Obtient ou définit une valeur indiquant si la CreateInstance(Type, ICollection, String, Boolean) méthode 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 s’il CreateInstance(Type, ICollection, String, Boolean) passe le nom du composant donné ; false s’il 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é modifié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 transmettra le nom du composant donné. Si false, CreateInstance vérifie la présence du nom donné dans le conteneur. Si le nom n’existe pas dans le conteneur, CreateInstance utilisez le nom donné. Si le nom existe dans le conteneur, CreateInstance passe une valeur Null comme nom d’un composant lors de son ajout au conteneur, lui donnant ainsi 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 ne pouvez modifier cette propriété que lorsque vous n’êtes pas dans une session de sérialisation.

Voir aussi

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