ObjectStateFormatter Klasa

Definicja

Serializować i deserializacji grafów obiektów, które reprezentują stan obiektu.Serializes and deserializes object graphs that represent the state of an object. Klasa ta nie może być dziedziczona.This class cannot be inherited.

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
Dziedziczenie
ObjectStateFormatter
Implementuje

Przykłady

Poniższy przykład kodu demonstruje, jak Klasa, która dziedziczy z PageStatePersister klasy, uzyskuje dostęp do StateFormatter właściwości, aby pobrać ObjectStateFormatter wystąpienie do serializacji stanu widoku i kontroli do strumienia.The following code example demonstrates how a class that derives from the PageStatePersister class accesses the StateFormatter property to retrieve an ObjectStateFormatter instance to serialize view state and control state to a stream. Ten przykład kodu jest częścią większego przykładu dostarczonego dla PageStatePersister klasy.This code example is part of a larger example provided for the PageStatePersister class.

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

Uwagi

Ostrzeżenie

BinaryFormatter jest niezabezpieczony i nie może być zabezpieczony.BinaryFormatter is insecure and can't be made secure. Aby uzyskać więcej informacji, zobacz Przewodnik po zabezpieczeniach BinaryFormatter.For more information, see the BinaryFormatter security guide.

ObjectStateFormatterKlasa serializować i deserializacji wykresów stanu obiektów w formacie kompaktowym.The ObjectStateFormatter class serializes and deserializes object state graphs in a compact format.

ObjectStateFormatter jest używany przez PageStatePersister klasę i klasy, które pochodzą od niej do serializacji stanu widoku i kontroli.ObjectStateFormatter is used by the PageStatePersister class and classes that derive from it to serialize view state and control state. Jest on również używany przez LosFormatter klasę w celu zapewnienia formatowania wykresu stanu obiektu dla różnych części infrastruktury ASP.NET.It is also used by the LosFormatter class to provide object state graph formatting for various parts of the ASP.NET infrastructure.

ObjectStateFormatterKlasa jest zoptymalizowana pod kątem serializacji i formatowania wielu wspólnych .NET Framework typów referencyjnych, a także stałych.The ObjectStateFormatter class is optimized to serialize and format many common .NET Framework reference types, as well as constants. Poniższa tabela zawiera listę typów, które są zoptymalizowane.The following table lists the types that are optimized.

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

Ponadto, podczas gdy konwencjonalne typy ciągów i tablice ciągów są zapisywane do i z niezmienionej serializowanego składnika zapisywania binarnego, niektóre ciągi są optymalizowane przez tworzenie wewnętrznych tabel ciągów.Additionally, while conventional string types and string arrays are written to and from a serialized binary writer unaltered, some strings are optimized by creating internal string tables. Ciągi są optymalizowane przy użyciu tych tabel, jeśli ciąg ma skojarzony TypeConverter obiekt lub jeśli ciąg jest w rzeczywistości wystąpieniem IndexedString klasy.Strings are optimized using these tables if the string has an associated TypeConverter object or if the string is actually an instance of the IndexedString class.

Inne typy, których nie wymieniono powyżej, są serializowane binarnie przy użyciu BinaryFormatter obiektu, jeśli implementują ISerializable interfejs lub mają SerializableAttribute atrybut.Other types not listed above are binary-serialized using a BinaryFormatter object if they implement the ISerializable interface or are decorated with the SerializableAttribute attribute. ObjectStateFormatterKlasa nie jest zoptymalizowana pod kątem żadnego z tych typów możliwych do serializacji.The ObjectStateFormatter class is not optimized for any of these serializable types.

Jeśli ObjectStateFormatter Klasa napotka typ, który nie jest możliwy do serializacji, ArgumentException zgłaszany jest wyjątek.If the ObjectStateFormatter class encounters a type that is not serializable, an ArgumentException exception is thrown.

Konstruktory

ObjectStateFormatter()

Inicjuje nowe wystąpienie klasy ObjectStateFormatter.Initializes a new instance of the ObjectStateFormatter class.

Metody

Deserialize(Stream)

Deserializacji grafu stanu obiektu z jego formy binarnej, która jest zawarta w określonym Stream obiekcie.Deserializes an object state graph from its binary-serialized form that is contained in the specified Stream object.

Deserialize(String)

Deserializacji grafu stanu obiektu z serializowanego formularza ciągu zakodowanego algorytmem Base64.Deserializes an object state graph from its serialized base64-encoded string form.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Serialize(Object)

Deserializacji grafu stanu obiektu do ciągu zakodowanego algorytmem Base64.Serializes an object state graph to a base64-encoded string.

Serialize(Stream, Object)

Deserializacji grafu stanu obiektu do określonego Stream obiektu.Serializes an object state graph to the specified Stream object.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IFormatter.Binder

Aby uzyskać opis tego elementu członkowskiego, zobacz Binder .For a description of this member, see Binder.

IFormatter.Context

Aby uzyskać opis tego elementu członkowskiego, zobacz Context .For a description of this member, see Context.

IFormatter.Deserialize(Stream)

Aby uzyskać opis tego elementu członkowskiego, zobacz Deserialize(Stream) .For a description of this member, see Deserialize(Stream).

IFormatter.Serialize(Stream, Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Serialize(Stream, Object) .For a description of this member, see Serialize(Stream, Object).

IFormatter.SurrogateSelector

Aby uzyskać opis tego elementu członkowskiego, zobacz SurrogateSelector .For a description of this member, see SurrogateSelector.

IStateFormatter.Deserialize(String)

Aby uzyskać opis tego elementu członkowskiego, zobacz Deserialize(String) .For a description of this member, see Deserialize(String).

IStateFormatter.Serialize(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Serialize(Object) .For a description of this member, see Serialize(Object).

Dotyczy