StateBag Classe

Definição

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

Object

StateBag

Implementações

ICollection IDictionary IEnumerable IStateManager

Exemplos

O exemplo de código a seguir demonstra um controle composto Label que tem Text propriedades e FontSize . Essas propriedades são salvas e recuperadas do estado de exibição quando o Control.Render método é chamado no controle .

// 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 é os valores de propriedade cumulativa, ou exibição, dessa página ou controle. Você pode acessar essa classe por meio da Control.ViewState propriedade . Os controles também podem armazenar informações de estado essenciais no estado de controle, mas essas informações não são armazenadas como um StateBag objeto.

Essa classe é o mecanismo de armazenamento primário para todos os controles html e servidor Web. Ele armazena pares de atributo/valor como cadeias de caracteres associadas ao controle . Ele controla as alterações nesses atributos somente depois que o OnInit 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.

Essa classe implementa um dicionário e você pode adicionar itens a ele ou remover itens dele como faria com qualquer objeto de dicionário. Para obter mais informações sobre coletas de dados, como dicionários, consulte Coleções e estruturas de dados.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a

Confira também

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• Coleções e Estruturas de Dados
• Visão geral do Gerenciamento de Estado do ASP.NET