StateBag Clase

Definición

Administra el estado de vista de los controles de servidor ASP.NET, incluidas las páginas.Manages the view state of ASP.NET server controls, including pages. Esta clase no puede heredarse.This class cannot be inherited.

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
StateBag
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra un control de Label compuesto que tiene propiedades Text y FontSize.The following code example demonstrates a composite Label control that has Text and FontSize properties. Estas propiedades se guardan y se recuperan del estado de vista cuando se llama al método Control.Render en el control.These properties are saved to and retrieved from view state when the Control.Render method is called on the 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 un control son los valores de propiedad acumulativos, o vista, de esa página o control.View state for a page or control is the cumulative property values, or view, of that page or control. Puede tener acceso a esta clase a través de la propiedad Control.ViewState.You can access this class through the Control.ViewState property. Los controles también pueden almacenar información de estado esencial en el estado del control, pero dicha información no se almacena como un objeto StateBag.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Esta clase es el mecanismo de almacenamiento principal para todos los controles de servidor HTML y Web.This class is the primary storage mechanism for all HTML and Web server controls. Almacena pares de atributo y valor como cadenas asociadas al control.It stores attribute/value pairs as strings associated with the control. Realiza el seguimiento de los cambios en estos atributos solo después de que se ejecute el método OnInit para una solicitud de página y guarda los cambios en el estado de vista del control o de la página.It tracks changes to these attributes only after the OnInit method is executed for a page request, and saves the changes to the page's or control's view state.

Esta clase implementa un diccionario y puede agregarle elementos o quitar elementos de él como lo haría con cualquier objeto de diccionario.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Para obtener más información sobre las colecciones de datos, como los diccionarios, vea colecciones y estructuras de datos.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Constructores

StateBag()

Inicializa una nueva instancia de la clase StateBag.Initializes a new instance of the StateBag class. Este es el constructor sin parámetros para esta clase.This is the parameterless constructor for this class.

StateBag(Boolean)

Inicializa una nueva instancia de la clase StateBag que permite que los valores de estado almacenados no distingan mayúsculas de minúsculas.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Propiedades

Count

Obtiene el número de objetos StateItem del objeto StateBag.Gets the number of StateItem objects in the StateBag object.

Item[String]

Obtiene o establece el valor de un elemento almacenado en el objeto StateBag.Gets or sets the value of an item stored in the StateBag object.

Keys

Obtiene una colección de claves que representa los elementos del objeto StateBag.Gets a collection of keys representing the items in the StateBag object.

Values

Obtiene una colección de los valores del estado de vista almacenados en el objeto StateBag.Gets a collection of the view-state values stored in the StateBag object.

Métodos

Add(String, Object)

Agrega un nuevo objeto StateItem al objeto StateBag.Adds a new StateItem object to the StateBag object. Si el elemento ya existe en el objeto StateBag, este método actualiza su valor.If the item already exists in the StateBag object, this method updates the value of the item.

Clear()

Quita todos los elementos del objeto StateBag actual.Removes all items from the current StateBag object.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Devuelve un enumerador que recorre en iteración los pares de clave/valor de los objetos StateItem almacenados en el objeto StateBag.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsItemDirty(String)

Comprueba un objeto StateItem almacenado en el objeto StateBag para evaluar si se ha modificado desde la llamada a TrackViewState().Checks a StateItem object stored in the StateBag object to evaluate whether it has been modified since the call to TrackViewState().

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(String)

Quita el par clave/valor especificado del objeto StateBag.Removes the specified key/value pair from the StateBag object.

SetDirty(Boolean)

Establece el estado del objeto StateBag así como la propiedad Dirty de cada uno de los objetos StateItem incluidos en él.Sets the state of the StateBag object as well as the Dirty property of each of the StateItem objects contained by it.

SetItemDirty(String, Boolean)

Establece la propiedad Dirty del objeto StateItem especificado en el objeto StateBag.Sets the Dirty property for the specified StateItem object in the StateBag object.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)

Para una descripción de este miembro, vea CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized

Para una descripción de este miembro, vea IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Para una descripción de este miembro, vea SyncRoot.For a description of this member, see SyncRoot.

IDictionary.Add(Object, Object)

Para una descripción de este miembro, vea Add(Object, Object).For a description of this member, see Add(Object, Object).

IDictionary.Contains(Object)

Para una descripción de este miembro, vea Contains(Object).For a description of this member, see Contains(Object).

IDictionary.IsFixedSize

Para una descripción de este miembro, vea IsFixedSize.For a description of this member, see IsFixedSize.

IDictionary.IsReadOnly

Para una descripción de este miembro, vea IsReadOnly.For a description of this member, see IsReadOnly.

IDictionary.Item[Object]

Para una descripción de este miembro, vea Item[Object].For a description of this member, see Item[Object].

IDictionary.Remove(Object)

Para una descripción de este miembro, vea Remove(Object).For a description of this member, see Remove(Object).

IEnumerable.GetEnumerator()

Para una descripción de este miembro, vea GetEnumerator().For a description of this member, see GetEnumerator().

IStateManager.IsTrackingViewState

Obtiene un valor que indica si se realiza un seguimiento de los cambios de estado.Gets a value indicating whether state changes are being tracked.

IStateManager.LoadViewState(Object)

Restaura el estado de vista guardado previamente del objeto StateBag.Restores the previously saved view state of the StateBag object.

IStateManager.SaveViewState()

Guarda los cambios realizados en el objeto StateBag desde el momento en que se devuelve la página al servidor.Saves the changes to the StateBag object since the time the page was posted back to the server.

IStateManager.TrackViewState()

Hace que el objeto StateBag realice el seguimiento de cambios a su estado para que se pueda guardar en todas las solicitudes.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: