PageStatePersister.ControlState Proprietà

Definizione

Ottiene o imposta un oggetto che rappresenta i dati utilizzati dai controlli contenuti nell'oggetto Page corrente per la persistenza tra le richieste HTTP inviate al server Web.Gets or sets an object that represents the data that controls contained by the current Page object use to persist across HTTP requests to the Web 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

Valore della proprietà

Object

Un oggetto che contiene i dati relativi allo stato di visualizzazione.An object that contains view state data.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato il modo in cui una classe che deriva dalla PageStatePersister classe inizializza la ControlState Proprietà.The following code example demonstrates how a class that derives from the PageStatePersister class initializes the ControlState property. In questo esempio, la ControlState proprietà è stata assegnata al Second campo di un Pair oggetto e serializzata usando la ObjectStateFormatter classe.In this example, the ControlState property has been assigned to the Second field of a Pair object, and serialized using the ObjectStateFormatter class. Quando Load viene chiamato il metodo, la ObjectStateFormatter classe viene utilizzata per deserializzare le informazioni sullo stato di visualizzazione e sullo stato del controllo e la ControlState proprietà viene inizializzata dal Pair campo dell'oggetto risultante Second .When the Load method is called, the ObjectStateFormatter class is used to deserialize view state and control state information, and the ControlState property is initialized from the resulting Pair object's Second field. Questo esempio di codice fa parte di un esempio più ampio fornito per la PageStatePersister classe.This code example is part of a larger example provided for the PageStatePersister class.

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

Commenti

Lo stato del controllo è un oggetto costituito da dati di stato di visualizzazione critici che devono essere rilevati dai controlli server Web e che sono contenuti in un oggetto separato dalle normali informazioni sullo stato di visualizzazione.Control state is an object comprised of critical view state data that Web server controls need to function, and is contained in a separate object from normal view state information. I dati sullo stato del controllo non sono interessati quando lo stato di visualizzazione è disabilitato al Page livello, ma richiede passaggi di implementazione aggiuntivi da usare.Control state data is not affected when view state is disabled at the Page level, but requires extra implementation steps to use. Per ulteriori informazioni sull'utilizzo ViewState dello stato della proprietà e del controllo durante lo sviluppo di controlli, vedere sviluppo di controlli server ASP.NET personalizzati.For more information on using the ViewState property and control state when developing controls, see Developing Custom ASP.NET Server Controls.

Si applica a