StateBag Clase

Definición

public ref class StateBag sealed : System::Collections::IDictionary, System::Web::UI::IStateManager

public sealed class StateBag : System.Collections.IDictionary, System.Web.UI.IStateManager

type StateBag = class
    interface IStateManager
    interface IDictionary
    interface ICollection
    interface IEnumerable

Public NotInheritable Class StateBag
Implements IDictionary, IStateManager

Herencia

Object

StateBag

Implementaciones

ICollection IDictionary IEnumerable IStateManager

Ejemplos

En el ejemplo de código siguiente se muestra un control compuesto Label que tiene Text propiedades y FontSize . Estas propiedades se guardan en y se recuperan del estado de vista cuando se llama al Control.Render método 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>");
        }
    }
}

' This control renders values stored in view state for Text and FontSize properties.

Imports System.Web
Imports System.Web.UI

Namespace ViewStateControlSamples

    Public Class CustomLabel : Inherits Control
        Private Const defaultFontSize As Integer = 3

        ' 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


        Public Property FontSize() As Integer
            Get
                Dim o As Object = ViewState("FontSize")
                If (IsNothing(o)) Then
                    Return defaultFontSize
                Else
                    Return CInt(ViewState("FontSize"))
                End If

            End Get
            Set(ByVal value As Integer)
                ViewState("FontSize") = value
            End Set
        End Property
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
        Protected Overrides Sub Render(ByVal Output As HtmlTextWriter)
            Output.Write("<font size=" & Me.FontSize & ">" & Me.Text & "</font>")
        End Sub

    End Class

End Namespace

Comentarios

El estado de vista de una página o control es los valores de propiedad acumulados, o vista, de esa página o control. Puede acceder a esta clase a través de la Control.ViewState propiedad . Los controles también pueden almacenar información de estado esencial en estado de control, pero esa información no se almacena como un StateBag objeto.

Esta clase es el mecanismo de almacenamiento principal para todos los controles html y de servidor web. Almacena pares atributo-valor como cadenas asociadas al control. Realiza un seguimiento de los cambios en estos atributos solo después de ejecutar el OnInit método para una solicitud de página y guarda los cambios en el estado de vista del control o de la página.

Esta clase implementa un diccionario y puede agregar elementos a él o quitar elementos de él como lo haría con cualquier objeto de diccionario. Para obtener más información sobre las colecciones de datos, como diccionarios, vea Colecciones y estructuras de datos.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Consulte también

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• Colecciones y estructuras de datos
• Información general sobre la administración de estado de ASP.NET