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 dérivée 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 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 du contrôle est un objet composé de données d’état d’affichage critiques dont les contrôles serveur web ont besoin pour fonctionner, et est contenu dans un objet distinct des informations d’état d’affichage 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écessite des étapes d’implémentation supplémentaires à utiliser. Pour plus d’informations sur l’utilisation de la ViewState propriété et de l’état du contrôle lors du développement de contrôles, consultez Développement de contrôles serveur de ASP.NET personnalisés.