PageStatePersister.ControlState Vlastnost

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Získá nebo nastaví objekt, který představuje data, které ovládací prvky obsažené v aktuálním Page objektu použít k zachování http požadavky na webový server.

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

Hodnota vlastnosti

Object

Objekt, který obsahuje data o stavu zobrazení.

Příklady

Následující příklad kódu ukazuje, jak třída, která je odvozena z PageStatePersister třídy inicializuje ControlState vlastnost. V tomto příkladu ControlState byla vlastnost přiřazena k Second poli objektu Pair a serializována pomocí ObjectStateFormatter třídy. Při zavolání LoadObjectStateFormatter metody se třída používá k deserializaci zobrazení a informací o stavu ovládacího prvku a ControlState vlastnost je inicializována z pole výsledného Pair objektu Second . Tento příklad kódu je součástí většího příkladu PageStatePersister pro třídu.

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

Poznámky

Stav ovládacího prvku je objekt, který se skládá z kritických dat o stavu zobrazení, které ovládací prvky webového serveru potřebují, aby fungovaly, a je obsažen v samostatném objektu od normálních informací o stavu zobrazení. Data stavu řízení nejsou ovlivněna, pokud je stav zobrazení na Page úrovni zakázán, ale vyžaduje další kroky implementace. Další informace o použití ViewState vlastnosti a stavu ovládacího prvku při vývoji ovládacích prvků najdete v tématu Vývoj vlastních ASP.NET serverových ovládacích prvků.