Control.ViewState Propriété

  • Référence

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 de 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 lorsque les requêtes suivantes sont traitées. Pour plus d’informations sur l’enregistrement de l’état d’affichage du contrôle de serveur, consultez ASP.NET Vue d’ensemble de la gestion de l’état.

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

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

S’applique à

Voir aussi