PageStatePersister.ControlState 屬性

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

取得或設定物件，表示對 Web 伺服器的 HTTP 要求之間，目前 Page 物件所包含的控制項用以保存的資料。

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 ，屬性已指派給 Second 物件的欄位 Pair ，並使用 類別 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

備註

控件狀態是由網頁伺服器控制項需要運作的重要檢視狀態數據所組成，而且包含在與一般檢視狀態資訊不同的物件中。 在層級停用 Page 檢視狀態時，控制狀態數據不會受到影響，但需要額外的實作步驟才能使用。 如需在開發控件時使用 ViewState 屬性和控件狀態的詳細資訊，請參閱 開發自定義 ASP.NET 伺服器控制件。