StateBag 클래스

정의

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

상속

Object

StateBag

구현

ICollection IDictionary IEnumerable IStateManager

예제

다음 코드 예제에서는 및 FontSize 속성이 있는 복합 Label 컨트롤을 Text 보여 줍니다. 이러한 속성은 에 저장되고 컨트롤에서 메서드가 Control.Render 호출될 때 뷰 상태에서 검색됩니다.

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

설명

페이지 또는 컨트롤의 보기 상태는 해당 페이지 또는 컨트롤의 누적 속성 값 또는 뷰입니다. 속성을 통해 이 클래스에 Control.ViewState 액세스할 수 있습니다. 컨트롤은 필수 상태 정보를 제어 상태에 저장할 수도 있지만 해당 정보는 개체로 StateBag 저장되지 않습니다.

이 클래스는 모든 HTML 및 웹 서버 컨트롤에 대한 기본 스토리지 메커니즘입니다. 특성/값 쌍을 컨트롤과 연결된 문자열로 저장합니다. 페이지 요청에 대해 메서드를 OnInit 실행한 후에만 이러한 특성의 변경 내용을 추적하고 변경 내용을 페이지 또는 컨트롤의 뷰 상태에 저장합니다.

이 클래스는 사전을 구현하며, 사전 개체와 마찬가지로 항목을 추가하거나 항목을 제거할 수 있습니다. 사전과 같은 데이터 컬렉션에 대한 자세한 내용은 컬렉션 및 데이터 구조를 참조하세요.

생성자

속성

메서드

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• 컬렉션 및 데이터 구조
• ASP.NET 상태 관리 개요