Control.ViewState Propriété

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.

protected:
 virtual property System::Web::UI::StateBag ^ ViewState { System::Web::UI::StateBag ^ get(); };

[System.ComponentModel.Browsable(false)]
protected virtual System.Web.UI.StateBag ViewState { get; }

[<System.ComponentModel.Browsable(false)>]
member this.ViewState : System.Web.UI.StateBag

Protected Overridable ReadOnly Property ViewState As StateBag

Valeur de propriété

StateBag

Instance de la classe StateBag qui contient les informations d'état d'affichage du contrôle serveur.

Attributs

BrowsableAttribute

Exemples

L’exemple suivant illustre l’implémentation d’une Text propriété qui stocke et récupère sa valeur à partir de la propriété de ViewState son contrôle.

// Add property values to view state with set;
// retrieve them from view state with get.
public String Text
{
    get 
    { 
        object o = ViewState["Text"]; 
        return (o == null)? String.Empty : (string)o;
    }

    set
    {
        ViewState["Text"] = value;
    }
}

' Add property values to view state with set; 
' retrieve them from view state with get.
Public Property [Text]() As String
    Get
        Dim o As Object = ViewState("Text")
        If (IsNothing(o)) Then
            Return String.Empty
        Else
            Return CStr(o)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("Text") = value
    End Set
End Property

Remarques

L’état d’affichage d’un contrôle serveur est l’accumulation de toutes ses valeurs de propriété. Pour conserver ces valeurs dans les requêtes HTTP, ASP.NET contrôles serveur utilisent cette propriété, qui est une instance de la StateBag classe, pour stocker les valeurs de propriété. Les valeurs sont ensuite passées en tant que variable à un élément d’entrée masqué HTML lors du traitement des demandes suivantes. Pour plus d’informations sur l’enregistrement de l’état d’affichage du contrôle de serveur, consultez Vue d’ensemble de la gestion de l’état ASP.NET.

L’état d’affichage est activé par défaut pour tous les contrôles serveur, mais il existe des circonstances dans lesquelles vous souhaitez le désactiver. Pour plus d’informations, consultez Vue d’ensemble des performances ASP.NET.

Pour plus d’informations sur les dictionnaires et leur utilisation, consultez Collections et structures de données.

Voir aussi

• StateBag
• Vue d’ensemble de la gestion de l’état ASP.NET