StateBag Třída

Definice

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

Dědičnost

Object

StateBag

Implementuje

ICollection IDictionary IEnumerable IStateManager

Příklady

Následující příklad kódu ukazuje složený Label ovládací prvek, který má Text vlastnosti a FontSize . Tyto vlastnosti jsou uloženy a načteny ze stavu zobrazení při Control.Render zavolání metody v ovládacím prvku.

// 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

Poznámky

Stav zobrazení stránky nebo ovládacího prvku představuje hodnoty kumulativní vlastnosti nebo zobrazení dané stránky nebo ovládacího prvku. K této třídě můžete přistupovat prostřednictvím Control.ViewState vlastnosti . Ovládací prvky mohou také ukládat základní informace o stavu řízení, ale tyto informace nejsou uloženy StateBag jako objekt.

Tato třída je primárním mechanismem úložiště pro všechny ovládací prvky HTML a webového serveru. Páry atributu a hodnoty jsou uloženy jako řetězce přidružené k ovládacímu prvku. Sleduje změny těchto atributů až po OnInit spuštění metody pro požadavek stránky a uloží změny do stavu zobrazení stránky nebo ovládacího prvku.

Tato třída implementuje slovník a můžete do něj přidávat položky nebo z něj odebírat položky stejně jako jakýkoli objekt slovníku. Další informace o shromažďování dat, jako jsou slovníky, najdete v tématu Kolekce a datové struktury.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• Kolekce a datové struktury
• Přehled správy stavu ASP.NET