StateBag (Clase)

El estado de vista de una página o control lo constituyen los valores acumulados de sus propiedades, o la vista, de dicha página o control. Se puede obtener acceso a esta clase mediante la propiedad Control.ViewState. Los controles también pueden almacenar información de estado esencial en el estado del control, pero dicha información no se almacena en forma de objeto StateBag.

Esta clase es el mecanismo de almacenamiento principal de todos los controles de servidor HTML y Web. Almacena pares atributo/valor en forma de cadenas asociadas al control. Realiza un seguimiento de los cambios realizados en estos atributos sólo después de que el método OnInit se ejecute para una solicitud de página, y guarda los cambios en el estado de vista de la página o del control.

Esta clase implementa un diccionario, donde se pueden agregar o quitar elementos del mismo modo que se haría con cualquier objeto de diccionario. Para obtener más información sobre las recolecciones de datos, como los diccionarios, vea Colecciones y estructuras de datos.

En el siguiente ejemplo de código se muestra un control Label compuesto que dispone de las propiedades Text y FontSize. Estas propiedades se guardan en el estado de vista y se recuperan del mismo cuando se llama al método Control.Render en el control.

// 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 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos