DesignerSerializationManager.PreserveNames Property
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Gets or sets a value indicating whether the CreateInstance method should check for the presence of the given name in the container.
Namespace: System.ComponentModel.Design.Serialization
Assembly: System.Design (in System.Design.dll)
Property Value
Type: System.Booleantrue if CreateInstance will pass the given component name; false if CreateInstance will check for the presence of the given name in the container. The default is true.
| Exception | Condition |
|---|---|
| InvalidOperationException |
This property was changed from within a serialization session. |
The PreserveNames property determines the behavior of the CreateInstance method. If true, CreateInstance will pass the given component name. If false, CreateInstance will check for the presence of the given name in the container. If the name does not exist in the container, CreateInstance will use the given name. If the name does exist in the container, CreateInstance will pass a null value as the name of a component when adding it to the container, thereby giving it a new name. This second variation is useful for implementing a serializer that always duplicates objects, rather than assuming those objects do not exist. Paste commands often use this type of serializer.
You can only change this property when you are not in a serialization session.
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Windows 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
