PageStatePersister.ControlState Propriété

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Obtient ou définit un objet qui représente les données que les contrôles contenus dans l'objet Page actuel utilisent pour la persistance à travers des requêtes HTTP au serveur Web.

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

Valeur de propriété

Object

Objet qui contient des données d'état d'affichage.

Exemples

L’exemple de code suivant montre comment une classe qui dérive de la PageStatePersister classe initialise la ControlState propriété. Dans cet exemple, la ControlState propriété a été affectée au Second champ d’un Pair objet et sérialisée à l’aide de la ObjectStateFormatter classe . Lorsque la Load méthode est appelée, la ObjectStateFormatter classe est utilisée pour désérialiser les informations d’état d’affichage et d’état de contrôle, et la ControlState propriété est initialisée à partir du champ de Second l’objet résultantPair. Cet exemple de code fait partie d’un exemple plus grand fourni pour la PageStatePersister classe .

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

Remarques

L’état de contrôle est un objet composé de données d’état d’affichage critiques dont les contrôles de serveur web ont besoin pour fonctionner, et est contenu dans un objet distinct des informations d’état de vue normales. Les données d’état de contrôle ne sont pas affectées lorsque l’état Page d’affichage est désactivé au niveau, mais nécessitent des étapes d’implémentation supplémentaires à utiliser. Pour plus d’informations sur l’utilisation de la ViewState propriété et de l’état de contrôle lors du développement de contrôles, consultez Développement de contrôles serveur ASP.NET personnalisés.