SerializationInfo.GetValue(String, Type) Método

Definição

Espaço de Nomes:
System.Runtime.Serialization
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Recupera um valor da SerializationInfo loja.

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 recuperar.

type
Type

O Type valor a recuperar. Se o valor armazenado não puder ser convertido para este tipo, o sistema lançará um InvalidCastException.

Devoluções

Object

O objeto do especificado Type associado a name.

Exceções

ArgumentNullException

name ou type é null.

InvalidCastException

O valor associado a name não pode ser convertido em type.

SerializationException

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

Exemplos

O seguinte exemplo de código demonstra a utilização 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

Observações

Se os dados armazenados SerializationInfo no são do tipo solicitado (ou de uma das suas classes derivadas), esse valor é devolvido diretamente. Caso contrário, IFormatterConverter.Convert é chamado para converter para o tipo apropriado.

O valor devolvido pelo GetValue método pode sempre ser lançado em segurança para o tipo especificado no type parâmetro.

Aplica-se a