ObjectStateFormatter Clase

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Serializa y deserializa gráficos de objetos que representan el estado de un objeto. Esta clase no puede heredarse.

public ref class ObjectStateFormatter sealed : System::Runtime::Serialization::IFormatter

public sealed class ObjectStateFormatter : System.Runtime.Serialization.IFormatter

type ObjectStateFormatter = class
    interface IStateFormatter
    interface IFormatter

Public NotInheritable Class ObjectStateFormatter
Implements IFormatter

Herencia

Object

ObjectStateFormatter

Implementaciones

IFormatter IStateFormatter

Ejemplos

En el ejemplo de código siguiente se muestra cómo una clase que deriva de la clase accede a la PageStatePersisterStateFormatter propiedad para recuperar una ObjectStateFormatter instancia para serializar el estado de vista y el estado de control en una secuencia. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase PageStatePersister.

//
// Persist any ViewState and ControlState.
//
public override void Save()
{

    if (ViewState != null || ControlState != null)
    {
        if (Page.Session != null)
        {
            Stream stateStream = GetSecureStream();

            StreamWriter writer = new StreamWriter(stateStream);

            IStateFormatter formatter = this.StateFormatter;
            Pair statePair = new Pair(ViewState, ControlState);

            // Serialize the statePair object to a string.
            string serializedState = formatter.Serialize(statePair);

            writer.Write(serializedState);
            writer.Close();
            stateStream.Close();
        }
        else
        {
            throw new InvalidOperationException("Session needed for StreamPageStatePersister.");
        }
    }
}

'
' Persist any ViewState and ControlState.
'
Public Overrides Sub Save()

    If Not (ViewState Is Nothing) OrElse Not (ControlState Is Nothing) Then
        If Not (Page.Session Is Nothing) Then

            Dim stateStream As Stream
            stateStream = GetSecureStream()

            ' Write a state string, using the StateFormatter.
            Dim writer As New StreamWriter(stateStream)

            Dim formatter As IStateFormatter
            formatter = Me.StateFormatter

            Dim statePair As New Pair(ViewState, ControlState)

            Dim serializedState As String
            serializedState = formatter.Serialize(statePair)

            writer.Write(serializedState)
            writer.Close()
            stateStream.Close()
        Else
            Throw New InvalidOperationException("Session needed for StreamPageStatePersister.")
        End If
    End If
End Sub

Comentarios

Advertencia

BinaryFormatter no es seguro y no se puede convertir en seguro. Para obtener más información, vea Guía de seguridad de BinaryFormatter.

La ObjectStateFormatter clase serializa y deserializa gráficos de estado de objeto en un formato compacto.

ObjectStateFormatter la usan la PageStatePersister clase y las clases que derivan de ella para serializar el estado de vista y el estado de control. También lo usa la LosFormatter clase para proporcionar formato de grafo de estado de objeto para varias partes de la infraestructura de ASP.NET.

La ObjectStateFormatter clase está optimizada para serializar y dar formato a muchos tipos de referencia comunes de .NET Framework, así como constantes. En la tabla siguiente se enumeran los tipos optimizados.

Array	DateTime	Int16	String
ArrayList	Double	Int32	Cadena []
Boolean	Enum	null (Nothing)	String.Empty
Byte	Hashtable	Pair	Triplet
Char	HybridDictionary	Single	Type
Color	IDictionary

Además, mientras que los tipos de cadena convencionales y las matrices de cadenas se escriben en y desde un escritor binario serializado sin modificar, algunas cadenas se optimizan mediante la creación de tablas de cadenas internas. Las cadenas se optimizan con estas tablas si la cadena tiene un objeto asociado TypeConverter o si la cadena es realmente una instancia de la IndexedString clase .

Otros tipos no enumerados anteriormente se serializan binariamente mediante un BinaryFormatter objeto si implementan la ISerializable interfaz o están decoradas con el SerializableAttribute atributo . La ObjectStateFormatter clase no está optimizada para ninguno de estos tipos serializables.

Si la ObjectStateFormatter clase encuentra un tipo que no es serializable, se produce una ArgumentException excepción.

Constructores

ObjectStateFormatter()

Inicializa una nueva instancia de la clase ObjectStateFormatter.

Métodos

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.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Serialize(Object)	Serializa un gráfico de estado de objeto a una cadena codificada en base64.
Serialize(Stream, Object)	Serializa un gráfico de estado de objeto al objeto Stream especificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IFormatter.Binder	Para obtener una descripción de este miembro, vea Binder.
IFormatter.Context	Para obtener una descripción de este miembro, vea Context.
IFormatter.Deserialize(Stream)	Para obtener una descripción de este miembro, vea Deserialize(Stream).
IFormatter.Serialize(Stream, Object)	Para obtener una descripción de este miembro, vea Serialize(Stream, Object).
IFormatter.SurrogateSelector	Para obtener una descripción de este miembro, vea SurrogateSelector.
IStateFormatter.Deserialize(String)	Para obtener una descripción de este miembro, vea Deserialize(String).
IStateFormatter.Serialize(Object)	Para obtener una descripción de este miembro, vea Serialize(Object).