DesignerSerializationManager.PreserveNames Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de CreateInstance(Type, ICollection, String, Boolean) methode moet controleren op de aanwezigheid van de opgegeven naam in de container.
public:
property bool PreserveNames { bool get(); void set(bool value); };public bool PreserveNames { get; set; }member this.PreserveNames : bool with get, setPublic Property PreserveNames As BooleanWaarde van eigenschap
true als CreateInstance(Type, ICollection, String, Boolean) de opgegeven onderdeelnaam wordt doorgegeven; false als CreateInstance(Type, ICollection, String, Boolean) wordt gecontroleerd op de aanwezigheid van de opgegeven naam in de container. De standaardwaarde is true.
Uitzonderingen
Deze eigenschap is gewijzigd vanuit een serialisatiesessie.
Opmerkingen
De PreserveNames eigenschap bepaalt het gedrag van de CreateInstance methode. Als true, CreateInstance geeft u de opgegeven onderdeelnaam door. Als false, CreateInstance controleert u op de aanwezigheid van de opgegeven naam in de container. Als de naam niet in de container bestaat, CreateInstance gebruikt u de opgegeven naam. Als de naam wel in de container bestaat, CreateInstance geeft u een null-waarde door als de naam van een onderdeel bij het toevoegen aan de container, waardoor deze een nieuwe naam krijgt. Deze tweede variatie is handig voor het implementeren van een serialisatiefunctie die objecten altijd dupliceren, in plaats van ervan uit te gaan dat deze objecten niet bestaan. Plakopdrachten gebruiken vaak dit type serializer.
U kunt deze eigenschap alleen wijzigen wanneer u zich niet in een serialisatiesessie bevindt.