Serialization (C++/CLI)
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at Serialization (C++/CLI).
Serialization (the process of storing the state of an object or member to a permanent medium) of managed classes (including individual fields or properties) is supported by the SerializableAttribute and NonSerializedAttribute classes.
Remarks
Apply the SerializableAttribute custom attribute to a managed class to serialize the entire class or apply only to specific fields or properties to serialize parts of the managed class. Use the NonSerializedAttribute custom attribute to exempt fields or properties of a managed class from being serialized.
Example
Description
In the following example, the class MyClass (and the property m_nCount) is marked as serializable. However, the m_nData property is not serialized as indicated by the NonSerialized custom attribute:
Code
// serialization_and_mcpp.cpp
// compile with: /LD /clr
using namespace System;
[ Serializable ]
public ref class MyClass {
public:
int m_nCount;
private:
[ NonSerialized ]
int m_nData;
};
Comments
Note that both attributes can be referenced using their "short name" (Serializable and NonSerialized). This is further explained in Applying Attributes.