ObjectStateFormatter Classe

Definição

public ref class ObjectStateFormatter sealed : System::Runtime::Serialization::IFormatter, System::Web::UI::IStateFormatter

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

public sealed class ObjectStateFormatter : System.Runtime.Serialization.IFormatter, System.Web.UI.IStateFormatter

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

type ObjectStateFormatter = class
    interface IStateFormatter
    interface IFormatter

Public NotInheritable Class ObjectStateFormatter
Implements IFormatter, IStateFormatter

Public NotInheritable Class ObjectStateFormatter
Implements IFormatter

Herança

Object

ObjectStateFormatter

Implementações

IFormatter IStateFormatter

Exemplos

O exemplo de código seguinte demonstra como uma classe que deriva da PageStatePersister classe acede à StateFormatter propriedade para recuperar uma ObjectStateFormatter instância para serializar o estado da vista e o estado de controlo para um fluxo. Este exemplo de código faz parte de um exemplo maior fornecido para a PageStatePersister classe.

//
// 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

Observações

A ObjectStateFormatter classe serializa e desserializa grafos de estado de objeto num formato compacto.

ObjectStateFormatter é usada pela PageStatePersister classe e pelas classes que dela derivam para serializar o estado de vista e o estado de controlo. É também utilizado pela classe LosFormatter para fornecer formatação de grafos de estado de objetos para várias partes da infraestrutura ASP.NET.

A classe ObjectStateFormatter está otimizada para serializar e formatar muitos tipos comuns de referência .NET Framework, bem como constantes. Os seguintes tipos são otimizados:

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

Além disso, embora os tipos convencionais de strings e os arrays de strings sejam escritos para e a partir de um gravador binário serializado sem alterações, algumas strings são otimizadas criando tabelas internas de strings. As cadeias são otimizadas usando estas tabelas se a cadeia tiver um objeto associado TypeConverter ou se a cadeia for realmente uma instância da IndexedString classe.

Outros tipos não listados acima são binários serializados usando um BinaryFormatter objeto se implementarem a ISerializable interface ou forem decorados com o SerializableAttribute atributo. A ObjectStateFormatter classe não está otimizada para nenhum destes tipos serializáveis.

Se a ObjectStateFormatter classe encontrar um tipo que não é serializável, é lançada uma ArgumentException exceção.