DesignerSerializationManager.PreserveNames Property
Gets or sets a value indicating whether the CreateInstance method should check for the presence of the given name in the container.
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 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.