PageStatePersister.ControlState プロパティ

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。

public:
 property System::Object ^ ControlState { System::Object ^ get(); void set(System::Object ^ value); };

public object ControlState { get; set; }

member this.ControlState : obj with get, set

Public Property ControlState As Object

プロパティ値

Object

ビューステート データを格納しているオブジェクト。

例

次のコード例は、 クラスから派生したクラスが プロパティを PageStatePersister 初期化する方法を ControlState 示しています。 この例では、 ControlState プロパティが オブジェクトの Pair フィールドにSecond割り当てられ、 クラスを使用してObjectStateFormatterシリアル化されています。 メソッドが Load 呼び出されると、 クラスを ObjectStateFormatter 使用してビューステートと制御状態情報が逆シリアル化され ControlState 、結果の Pair オブジェクトの Second フィールドから プロパティが初期化されます。 このコード例は、PageStatePersister クラスのために提供されている大規模な例の一部です。

//
// Load ViewState and ControlState.
//
public override void Load()
{
    Stream stateStream = GetSecureStream();

    // Read the state string, using the StateFormatter.
    StreamReader reader = new StreamReader(stateStream);

    IStateFormatter formatter = this.StateFormatter;
    string fileContents = reader.ReadToEnd();

    // Deserilize returns the Pair object that is serialized in
    // the Save method.
    Pair statePair = (Pair)formatter.Deserialize(fileContents);

    ViewState = statePair.First;
    ControlState = statePair.Second;
    reader.Close();
    stateStream.Close();
}

'
' Load ViewState and ControlState.
'
Public Overrides Sub Load()

    Dim stateStream As Stream
    stateStream = GetSecureStream()

    ' Read the state string, using the StateFormatter.
    Dim reader As New StreamReader(stateStream)

    Dim serializedStatePair As String
    serializedStatePair = reader.ReadToEnd
    Dim statePair As Pair

    Dim formatter As IStateFormatter
    formatter = Me.StateFormatter

    ' Deserilize returns the Pair object that is serialized in
    ' the Save method.      
    statePair = CType(formatter.Deserialize(serializedStatePair), Pair)

    ViewState = statePair.First
    ControlState = statePair.Second
    reader.Close()
    stateStream.Close()
End Sub

注釈

コントロール状態は、Web サーバー コントロールが機能するために必要な重大なビューステート データで構成されるオブジェクトであり、通常のビュー ステート情報とは別のオブジェクトに含まれています。 ビュー ステートがレベルで無効になっている場合、制御状態データは影響を受けませんが、使用するには追加の Page 実装手順が必要です。 コントロールの開発時に プロパティとコントロールの状態を ViewState 使用する方法の詳細については、「 Developing Custom ASP.NET Server Controls」を参照してください。