DesignerSerializationManager.PreserveNames 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 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é
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
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.