SerializationInfoEnumerator Class
Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. This class cannot be inherited.
Assembly: mscorlib (in mscorlib.dll)
The SerializationInfoEnumerator type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | Current | Gets the item currently being examined. |
![]() | Name | Gets the name for the item currently being examined. |
![]() | ObjectType | Gets the type of the item currently being examined. |
![]() | Value | Gets the value of the item currently being examined. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | MoveNext | Updates the enumerator to the next item. |
![]() | Reset | Resets the enumerator to the first item. |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
The current class is a standard enumerator that parses over the values stored in SerializationInfo. Instead of recording the values, the SerializationInfoEnumerator keeps pointers to the member variables of the SerializationInfo that created it.
This class follows the IEnumerator mechanism.
The following code example shows how to use the FormatterServices class in order to properly serialize or deserialize an object where the base class does not implement ISerializable but the derived class does.
using namespace System; using namespace System::IO; using namespace System::Runtime::Serialization; using namespace System::Runtime::Serialization::Formatters; using namespace System::Runtime::Serialization::Formatters::Binary; using namespace System::Reflection; using namespace System::Security::Permissions; // Person is a serializable base class. [Serializable] public ref class Person { private: String^ title; public: Person(String^ title) { this->title = title; } public: virtual String^ ToString() override { return String::Format("{0}", title); } }; // Employee is a serializable class derived from Person. [Serializable] public ref class Employee : public Person { private: String^ title; public: Employee(String^ title) : Person("Person") { this->title = title; } public: virtual String^ ToString() override { return String::Format("{0} -> {1}", title, Person::ToString()); } }; // Manager is a serializable and ISerializable class derived from Employee. [Serializable] ref class Manager : public Employee, public ISerializable { private: String^ title; public: Manager() : Employee("Employee") { this->title = "Manager"; } public: [SecurityPermission(SecurityAction::Demand, SerializationFormatter = true)] virtual void GetObjectData(SerializationInfo^ info, StreamingContext context) { // Serialize the desired values for this class. info->AddValue("title", title); // Get the set of serializable members for the class and base classes. Type^ thisType = this->GetType(); array<MemberInfo^>^ serializableMembers = FormatterServices::GetSerializableMembers(thisType, context); // Serialize the base class's fields to the info object. for each (MemberInfo^ serializableMember in serializableMembers) { // Do not serialize fields for this class. if (serializableMember->DeclaringType != thisType) { // Skip this field if it is marked NonSerialized. if (!(Attribute::IsDefined(serializableMember, NonSerializedAttribute::typeid))) { // Get the value of this field and add it to the // SerializationInfo object. info->AddValue(serializableMember->Name, ((FieldInfo^)serializableMember)->GetValue(this)); } } } // Call the method below to see the contents of the // SerializationInfo object. DisplaySerializationInfo(info); } private: static void DisplaySerializationInfo(SerializationInfo^ info) { Console::WriteLine("Values in the SerializationInfo:"); for each (SerializationEntry^ infoEntry in info) { Console::WriteLine("Name={0}, ObjectType={1}, Value={2}", infoEntry->Name, infoEntry->ObjectType, infoEntry->Value); } } protected: Manager(SerializationInfo^ info, StreamingContext context) : Employee(nullptr) { // Get the set of serializable members for the class and base classes. Type^ thisType = this->GetType(); array<MemberInfo^>^ serializableMembers = FormatterServices::GetSerializableMembers(thisType, context); // Deserialize the base class's fields from the info object. for each (MemberInfo^ serializableMember in serializableMembers) { // Do not deserialize fields for this class. if (serializableMember->DeclaringType != thisType) { // For easier coding, treat the member as a FieldInfo object FieldInfo^ fieldInformation = (FieldInfo^)serializableMember; // Skip this field if it is marked NonSerialized. if (!(Attribute::IsDefined(serializableMember, NonSerializedAttribute::typeid))) { // Get the value of this field from the // SerializationInfo object. fieldInformation->SetValue(this, info->GetValue(fieldInformation->Name, fieldInformation->FieldType)); } } } // Deserialize the values that were serialized for this class. title = info->GetString("title"); } public: virtual String^ ToString() override { return String::Format("{0} -> {1}", title, Employee::ToString()); } }; int main() { Stream^ stream = gcnew MemoryStream(); IFormatter^ formatter = gcnew BinaryFormatter(); Manager^ m = gcnew Manager(); Console::WriteLine(m->ToString()); formatter->Serialize(stream, m); stream->Position = 0; m = (Manager^) formatter->Deserialize(stream); Console::WriteLine(m->ToString()); } // This code produces the following output. // // Manager -> Employee -> Person // Values in the SerializaitonInfo: // Name=title, ObjectType=System.String, Value=Manager // Name=Employee+title, ObjectType=System.String, Value=Employee // Name=Person+title, ObjectType=System.String, Value=Person // Manager -> Employee -> Person
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.

