Export (0) Print
Expand All

SerializationInfo.GetValue Method

Retrieves a value from the SerializationInfo store.

Namespace:  System.Runtime.Serialization
Assembly:  mscorlib (in mscorlib.dll)

public Object GetValue(
	string name,
	Type type
)

Parameters

name
Type: System.String

The name associated with the value to retrieve.

type
Type: System.Type

The Type of the value to retrieve. If the stored value cannot be converted to this type, the system will throw a InvalidCastException.

Return Value

Type: System.Object
The object of the specified Type associated with name.

ExceptionCondition
ArgumentNullException

name or type is null.

InvalidCastException

The value associated with name cannot be converted to type.

SerializationException

An element with the specified name is not found in the current instance.

If the data stored in the SerializationInfo is of the type requested (or one of its derived classes), that value is returned directly. Otherwise, IFormatterConverter.Convert is called to convert it to the appropriate type.

The value returned by the GetValue method can always be safely cast to the type specified in the type parameter.

The following code example demonstrates the use of the GetValue method:

// A serializable LinkedList example.  For the full LinkedList implementation 
// see the Serialization sample.
[Serializable()]
class LinkedList: ISerializable {

   public static void Main() {}

   Node m_head = null;
   Node m_tail = null;

   // Serializes the object.
   [SecurityPermissionAttribute(SecurityAction.Demand, SerializationFormatter=true)]
   public void GetObjectData(SerializationInfo info, StreamingContext context){
      // Stores the m_head and m_tail references in the SerializationInfo info.
      info.AddValue("head", m_head, m_head.GetType());
      info.AddValue("tail", m_tail, m_tail.GetType());
   }

   // Constructor that is called automatically during deserialization. 
   // Reconstructs the object from the information in SerializationInfo info
   [SecurityPermissionAttribute(SecurityAction.Demand, SerializationFormatter=true)]
   private LinkedList(SerializationInfo info, StreamingContext context)
   {      
      Node temp = new Node(0);
      // Retrieves the values of Type temp.GetType() from SerializationInfo info
      m_head = (Node)info.GetValue("head", temp.GetType());
      m_tail = (Node)info.GetValue("tail", temp.GetType());
   }
}
// A serializable LinkedList example.  For the full LinkedList implementation
// see the Serialization sample.
[Serializable]
__gc class LinkedList: public ISerializable {

   Node* m_head;
   Node* m_tail;

   // Serializes the object.
public:
   void GetObjectData(SerializationInfo* info, StreamingContext /*context*/){
      // Stores the m_head and m_tail references in the SerializationInfo info.
      info->AddValue(S"head", m_head, m_head->GetType());
      info->AddValue(S"tail", m_tail, m_tail->GetType());
   }

   // Constructor that is called automatically during deserialization.
   // Reconstructs the object from the information in SerializationInfo info
private:
   LinkedList(SerializationInfo* info, StreamingContext /*context*/){      
      Node* temp = new Node(0);
      // Retrieves the values of Type temp.GetType() from SerializationInfo info
      m_head = dynamic_cast<Node*>(info->GetValue(S"head", temp->GetType()));
      m_tail = dynamic_cast<Node*>(info->GetValue(S"tail", temp->GetType()));
   }
};

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft