PageStatePersister.StateFormatter プロパティ

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

IStateFormatter メソッドおよび ViewState メッソドへの呼び出しで、ControlState プロパティおよび Save() プロパティに格納されている状態情報のシリアル化と逆シリアル化に使用する Load() オブジェクトを取得します。

protected:
 property System::Web::UI::IStateFormatter ^ StateFormatter { System::Web::UI::IStateFormatter ^ get(); };

protected System.Web.UI.IStateFormatter StateFormatter { get; }

member this.StateFormatter : System.Web.UI.IStateFormatter

Protected ReadOnly Property StateFormatter As IStateFormatter

プロパティ値

IStateFormatter

オブジェクトの状態のシリアル化と逆シリアル化に使用する IStateFormatter のインスタンス。

例

次のコード例は、クラスから PageStatePersister 派生したクラスがプロパティにアクセス StateFormatter して、ビューステートと制御状態を ObjectStateFormatter ストリームにシリアル化するために、インターフェイスの既定の IStateFormatter 実装であるオブジェクトを取得する方法を示しています。 このコード例は、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

注釈

プロパティを StateFormatter オーバーライドして、独自のビュー ステート フォーマッタを提供できます。