ObjectStateFormatter.Deserialize Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Deserializa un gráfico de estado de objeto partiendo del formato serializado.

Sobrecargas

Deserialize(Stream)	Deserializa un gráfico de estado de objeto de su formato serializado como binario contenido en el objeto Stream especificado.
Deserialize(String)	Deserializa un gráfico de estado de objeto partiendo de su formato de cadena serializada codificada en base64.

Comentarios

Importante

Llamar a este método con datos que no son de confianza supone un riesgo de seguridad. Llame a este método solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Deserialize(Stream)

Deserializa un gráfico de estado de objeto de su formato serializado como binario contenido en el objeto Stream especificado.

public:
 System::Object ^ Deserialize(System::IO::Stream ^ inputStream);

public object Deserialize (System.IO.Stream inputStream);

member this.Deserialize : System.IO.Stream -> obj

Public Function Deserialize (inputStream As Stream) As Object

Parámetros

inputStream

Stream

Objeto Stream que ObjectStateFormatter deserializa en un object.

Devoluciones

Object

Objeto que representa el gráfico de estado de un objeto deserializado.

Excepciones

ArgumentNullException

El inputStream especificado es null.

ArgumentException

Se produce una excepción durante la deserialización del objeto Stream. El mensaje de excepción se agrega al mensaje del objeto ArgumentException.

Ejemplos

En el ejemplo de código siguiente se muestra cómo una clase que deriva de la PageStatePersister clase inicializa la ViewState colección. En este ejemplo, la ViewState colección se ha asignado al First campo de un Pair objeto y se serializa en un archivo mediante la ObjectStateFormatter clase . Cuando se llama al Load método , el Deserialize(Stream) método se usa para deserializar el estado de vista del archivo y se inicializa la ViewState propiedad . Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase PageStatePersister.

//
// Load ViewState and ControlState.
//
public override void Load()
{
    Stream stateStream = GetSecureStream();

    // Read the state string, using the StateFormatter.
    StreamReader reader = new StreamReader(stateStream);

    IStateFormatter formatter = this.StateFormatter;
    string fileContents = reader.ReadToEnd();

    // Deserilize returns the Pair object that is serialized in
    // the Save method.
    Pair statePair = (Pair)formatter.Deserialize(fileContents);

    ViewState = statePair.First;
    ControlState = statePair.Second;
    reader.Close();
    stateStream.Close();
}

'
' Load ViewState and ControlState.
'
Public Overrides Sub Load()

    Dim stateStream As Stream
    stateStream = GetSecureStream()

    ' Read the state string, using the StateFormatter.
    Dim reader As New StreamReader(stateStream)

    Dim serializedStatePair As String
    serializedStatePair = reader.ReadToEnd
    Dim statePair As Pair

    Dim formatter As IStateFormatter
    formatter = Me.StateFormatter

    ' Deserilize returns the Pair object that is serialized in
    ' the Save method.      
    statePair = CType(formatter.Deserialize(serializedStatePair), Pair)

    ViewState = statePair.First
    ControlState = statePair.Second
    reader.Close()
    stateStream.Close()
End Sub

Comentarios

Cualquier gráfico de estado de objeto que se serialice con el Serialize método se puede deserializar con el Deserialize método . El Deserialize(Stream) método se usa para restaurar un gráfico de estado de objeto almacenado en Stream, como .FileStream

Importante

Llamar a este método con datos que no son de confianza supone un riesgo de seguridad. Llame a este método solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Deserialize(String)

Deserializa un gráfico de estado de objeto partiendo de su formato de cadena serializada codificada en base64.

public:
 System::Object ^ Deserialize(System::String ^ inputString);

public object Deserialize (string inputString);

member this.Deserialize : string -> obj

Public Function Deserialize (inputString As String) As Object

Parámetros

inputString

String

Cadena que la interfaz ObjectStateFormatter deserializa en un objeto inicializado.

Devoluciones

Object

Objeto que representa el gráfico de estado de un objeto deserializado.

Excepciones

ArgumentNullException

El parámetro inputString especificado es null o tiene una propiedad Length de 0.

ArgumentException

Los datos serializados no son válidos.

HttpException

Comprobación de la validación del código de autenticación de equipos (MAC) que se realiza cuando da error la deserialización del estado de vista.

Ejemplos

En el ejemplo de código siguiente se muestra cómo implementar un método que deserializa una cadena codificada en base64 y devuelve una ICollection colección de valores de propiedad. Este ejemplo de código se basa en la configuración de propiedad que se ha serializado con la ObjectStateFormatter clase , como se muestra en el Serialize(Object) método .

private ICollection LoadControlProperties (string serializedProperties) {

    ICollection controlProperties = null;

    // Create an ObjectStateFormatter to deserialize the properties.
    ObjectStateFormatter formatter = new ObjectStateFormatter();

    // Call the Deserialize method.
    controlProperties = (ArrayList) formatter.Deserialize(serializedProperties);

    return controlProperties;
}

Private Function LoadControlProperties(serializedProperties As String) As ICollection
   
   Dim controlProperties As ICollection = Nothing
   
   ' Create an ObjectStateFormatter to deserialize the properties.
   Dim formatter As New ObjectStateFormatter()
   
   ' Call the Deserialize method.
   controlProperties = CType(formatter.Deserialize(serializedProperties), ArrayList)
   
   Return controlProperties
End Function 'LoadControlProperties

Comentarios

Cualquier gráfico de estado de objeto que se serialice con el Serialize método se puede deserializar con el Deserialize método . El Deserialize(String) método se usa para restaurar un gráfico de estado de objeto almacenado en forma de cadena codificada en base64.

Importante

Llamar a este método con datos que no son de confianza supone un riesgo de seguridad. Llame a este método solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.