ObjectStateFormatter Sınıf

Tanım

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

Devralma

Object

ObjectStateFormatter

Uygulamalar

IFormatter IStateFormatter

Örnekler

Aşağıdaki kod örneği, sınıfından PageStatePersister türetilen bir sınıfın görünüm durumunu ve denetim durumunu akışa seri hale getirmek üzere bir ObjectStateFormatter örneği almak için özelliğine nasıl eriştiği StateFormatter gösterir. Bu kod örneği, sınıfı için PageStatePersister sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

sınıfı, ObjectStateFormatter nesne durumu grafiklerini sıkıştırılmış biçimde serileştirir ve seri durumdan çıkartır.

ObjectStateFormatter , görünüm durumunu ve denetim durumunu serileştirmek için ondan türetilen sınıflar ve sınıflar tarafından PageStatePersister kullanılır. Ayrıca sınıfı tarafından ASP.NET altyapısının LosFormatter çeşitli bölümleri için nesne durumu grafı biçimlendirmesi sağlamak için kullanılır.

ObjectStateFormatter sınıfı, birçok yaygın .NET Framework başvuru türünü ve sabitleri seri hale getirmek ve biçimlendirmek için iyileştirilmiştir. Aşağıdaki tabloda iyileştirilmiş türler listelenmiştir.

Buna ek olarak, geleneksel dize türleri ve dize dizileri sıralanmamış bir ikili yazıcıya ve bu yazıcıdan yazılırken, bazı dizeler iç dize tabloları oluşturularak iyileştirilir. Dizenin ilişkili TypeConverter bir nesnesi varsa veya dize aslında sınıfın bir örneğiyse IndexedString , dizeler bu tablolar kullanılarak iyileştirilir.

Yukarıda listelenmeyen diğer türler, arabirimini uygularlarsa ISerializable veya özniteliğiyle SerializableAttribute dekore edilirlerse bir BinaryFormatter nesne kullanılarak ikili seri hale getirilir. sınıfı ObjectStateFormatter , bu seri hale getirilebilir türlerin hiçbiri için iyileştirilmemiştir.

ObjectStateFormatter Sınıf seri hale getirilemeyen bir türle karşılaşırsa, bir ArgumentException özel durum oluşturulur.

Oluşturucular

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır