SerializationInfo.GetValue(String, Type) Método

Definição

Namespace:
System.Runtime.Serialization
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Recupera um valor do repositório SerializationInfo .

public:
 System::Object ^ GetValue(System::String ^ name, Type ^ type);
public object GetValue(string name, Type type);
member this.GetValue : string * Type -> obj
Public Function GetValue (name As String, type As Type) As Object

Parâmetros

name
String

O nome associado ao valor a ser recuperado.

type
Type

O Type valor a ser recuperado. Se o valor armazenado não puder ser convertido nesse tipo, o sistema gerará um InvalidCastException.

Retornos

Object

O objeto do especificado Type associado a name.

Exceções

ArgumentNullException

name ou type é null.

InvalidCastException

O valor associado name não pode ser convertido typeem .

SerializationException

Um elemento com o nome especificado não é encontrado na instância atual.

Exemplos

O exemplo de código a seguir demonstra o uso do GetValue método:

// 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.
   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
   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()> Class LinkedList
    Implements ISerializable

    Public Shared Sub Main()
    End Sub

    Private m_head As Node = Nothing
    Private m_tail As Node = Nothing    
    
    ' Serializes the object.
    Public Sub GetObjectData(info As SerializationInfo, _
    context As StreamingContext) Implements ISerializable.GetObjectData
    
        ' 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())
    End Sub
    
    
    ' Constructor that is called automatically during deserialization.
    ' Reconstructs the object from the information in SerializationInfo info.
    Private Sub New(info As SerializationInfo, context As StreamingContext)
        Dim temp As New Node(0)
        ' Retrieves the values of Type temp.GetType() from SerializationInfo info.
        m_head = CType(info.GetValue("head", temp.GetType()), Node)
        m_tail = CType(info.GetValue("tail", temp.GetType()), Node)
    End Sub
End Class

Comentários

Se os dados armazenados no SerializationInfo tipo solicitado (ou uma de suas classes derivadas), esse valor será retornado diretamente. Caso contrário, IFormatterConverter.Convert será chamado para convertê-lo no tipo apropriado.

O valor retornado pelo GetValue método sempre pode ser convertido com segurança no tipo especificado no type parâmetro.

Aplica-se a