DesignerSerializationManager.ValidateRecycledTypes 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 flag indicating whether the CreateInstance method will verify that matching names refer to the same type.
Namespace: System.ComponentModel.Design.Serialization
Assembly: System.Design (in System.Design.dll)
Property Value
Type: System.Booleantrue if CreateInstance verifies types; otherwise, false if it does not. The default is true.
| Exception | Condition |
|---|---|
| InvalidOperationException |
The serialization manager has an active serialization session. |
The ValidateRecycledTypes property modifies the behavior of the CreateInstance method when the RecycleInstances property is true, as detailed in the following table.
|
RecycleInstances |
ValidateRecycledTypes |
Behavior of CreateInstance |
|---|---|---|
|
false |
true or false |
Always create a new instance of the specified type |
|
true |
false |
If a matching instance is found it is returned, regardless of its type. |
|
true |
true |
If a matching instance is found, it is returned only if its type is the same as specified in the method call. |
ValidateRecycledTypes is useful for morphing one type of object to another if they have similar properties but share no common parent or interface.
- 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.
