StateBag StateBag StateBag StateBag Class

Definição

Gerencia o estado de exibição de controles de servidor ASP.NET, incluindo páginas.Manages the view state of ASP.NET server controls, including pages. Essa classe não pode ser herdada.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
Herança
StateBagStateBagStateBagStateBag
Implementações

Exemplos

O exemplo de código a seguir demonstra Label um controle composto Text que FontSize tem propriedades e.The following code example demonstrates a composite Label control that has Text and FontSize properties. Essas propriedades são salvas em e recuperadas do estado de Control.Render exibição quando o método é chamado no controle.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

Comentários

O estado de exibição de uma página ou controle são os valores de propriedade cumulativas ou a exibição dessa página ou controle.View state for a page or control is the cumulative property values, or view, of that page or control. Você pode acessar essa classe por meio Control.ViewState da propriedade.You can access this class through the Control.ViewState property. Os controles também podem armazenar informações de estado essenciais no estado de controle, mas essas informações não são StateBag armazenadas como um objeto.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Essa classe é o mecanismo de armazenamento primário para todos os controles de servidor Web e HTML.This class is the primary storage mechanism for all HTML and Web server controls. Ele armazena pares de atributo/valor como cadeias de caracteres associadas ao controle.It stores attribute/value pairs as strings associated with the control. Ele controla as alterações a esses atributos somente depois OnInit que o método é executado para uma solicitação de página e salva as alterações no estado de exibição da página ou do controle.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.

Essa classe implementa um dicionário e você pode adicionar itens a ele ou remover itens dele como faria com qualquer objeto Dictionary.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Para obter mais informações sobre coleções de dados, como dicionários, consulte coleções e estruturas de dados.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Construtores

StateBag() StateBag() StateBag() StateBag()

Inicializa uma nova instância da classe StateBag.Initializes a new instance of the StateBag class. Esse é o construtor sem parâmetros para essa classe.This is the parameterless constructor for this class.

StateBag(Boolean) StateBag(Boolean) StateBag(Boolean) StateBag(Boolean)

Inicializa uma nova instância da classe StateBag que permite que os valores de estado armazenados diferenciem maiúsculas de minúsculas.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Propriedades

Count Count Count Count

Obtém o número de objetos StateItem no objeto StateBag.Gets the number of StateItem objects in the StateBag object.

Item[String] Item[String] Item[String] Item[String]

Obtém ou define o valor de um item armazenado no objeto StateBag.Gets or sets the value of an item stored in the StateBag object.

Keys Keys Keys Keys

Obtém uma coleção de chaves que representa os itens no objeto StateBag.Gets a collection of keys representing the items in the StateBag object.

Values Values Values Values

Obtém uma coleção dos valores de estado de exibição armazenados no objeto StateBag.Gets a collection of the view-state values stored in the StateBag object.

Métodos

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Adiciona um novo objeto StateItem ao objeto StateBag.Adds a new StateItem object to the StateBag object. Se o item já existe no objeto StateBag, esse método atualizará o valor do item.If the item already exists in the StateBag object, this method updates the value of the item.

Clear() Clear() Clear() Clear()

Remove todos os itens do objeto StateBag atual.Removes all items from the current StateBag object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Retorna um enumerador que itera em todos os pares chave/valor dos objetos StateItem armazenados no objeto StateBag.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
IsItemDirty(String) IsItemDirty(String) IsItemDirty(String) IsItemDirty(String)

Verifica um objeto StateItem armazenado no objeto StateBag a para avaliar se ele foi modificado desde a chamada para TrackViewState().Checks a StateItem object stored in the StateBag object to evaluate whether it has been modified since the call to TrackViewState().

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Remove o par chave/valor especificado do objeto StateBag.Removes the specified key/value pair from the StateBag object.

SetDirty(Boolean) SetDirty(Boolean) SetDirty(Boolean) SetDirty(Boolean)

Define o estado do objeto StateBag, bem como a propriedade Dirty de cada um dos objetos StateItem contidos nela.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) SetItemDirty(String, Boolean) SetItemDirty(String, Boolean) SetItemDirty(String, Boolean)

Define a propriedade Dirty para o objeto StateItem especificado no objeto StateBag.Sets the Dirty property for the specified StateItem object in the StateBag object.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Para obter uma descrição desse membro, consulte CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Para obter uma descrição desse membro, consulte IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Para obter uma descrição desse membro, consulte SyncRoot.For a description of this member, see SyncRoot.

IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object)

Para obter uma descrição desse membro, consulte Add(Object, Object).For a description of this member, see Add(Object, Object).

IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object)

Para obter uma descrição desse membro, consulte Contains(Object).For a description of this member, see Contains(Object).

IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize

Para obter uma descrição desse membro, consulte IsFixedSize.For a description of this member, see IsFixedSize.

IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly

Para obter uma descrição desse membro, consulte IsReadOnly.For a description of this member, see IsReadOnly.

IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object]

Para obter uma descrição desse membro, consulte Item[Object].For a description of this member, see Item[Object].

IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object)

Para obter uma descrição desse membro, consulte Remove(Object).For a description of this member, see Remove(Object).

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Para obter uma descrição desse membro, consulte GetEnumerator().For a description of this member, see GetEnumerator().

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Obtém um valor que indica se as alterações de estado estão sendo controladas.Gets a value indicating whether state changes are being tracked.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente do objeto StateBag.Restores the previously saved view state of the StateBag object.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Salva as alterações no objeto StateBag desde a hora em que a página foi postada novamente no servidor.Saves the changes to the StateBag object since the time the page was posted back to the server.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Faz com que o objeto StateBag controle as alterações em seu estado, para que elas sejam mantidas em todas as solicitações.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Métodos de Extensão

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também