StateBag, classe

L'état d'affichage d'une page ou d'un contrôle correspond aux valeurs de propriété cumulées, ou à l'affichage, de cette page ou de ce contrôle. Vous pouvez accéder à cette classe via la propriété Control.ViewState. Les contrôles peuvent également stocker des informations d'état essentielles dans l'état du contrôle, mais ces informations ne sont pas stockées sous forme d'objet StateBag.

Cette classe correspond au mécanisme de stockage principal pour tous les contrôles serveur HTML et Web. Elle stocke les paires attribut/valeur sous forme de chaînes associées au contrôle. Elle assure le suivi des modifications apportées à ces attributs uniquement après l'exécution de la méthode OnInit pour une requête de page et enregistre les modifications de l'état d'affichage de la page ou du contrôle.

Cette classe implémente un dictionnaire et vous pouvez ajouter ou supprimer des éléments de ce dernier comme n'importe quel objet du dictionnaire. Pour plus d'informations sur les collections de données, telles que les dictionnaires, consultez Collections et structures de données.

L'exemple de code suivant montre un contrôle composite Label qui a des propriétés Text et FontSize. Ces propriétés sont enregistrées et récupérées de l'état d'affichage lorsque la méthode Control.Render est appelée sur le contrôle.

// This control renders values stored in view state for Text and FontSize properties.
using System;
using System.Web;
using System.Web.UI;

namespace ViewStateControlSamples
{

    public class CustomLabel : Control
    {
        private const int defaultFontSize = 3;

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


        public int FontSize
        {
            get
            {
                object o = ViewState["FontSize"];
                return (o == null) ? defaultFontSize : (int)o;
            }
            set
            {
                ViewState["FontSize"] = value;
            }
        }

        [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name = "FullTrust")]
        protected override void Render(HtmlTextWriter output)
        {
            output.Write("<font size=" + this.FontSize.ToString() + ">" + this.Text + "</font>");
        }
    }
}

.NET Framework

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources