StateBag Sınıf

Tanım

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

Devralma

Object

StateBag

Uygulamalar

ICollection IDictionary IEnumerable IStateManager

Örnekler

Aşağıdaki kod örneğinde ve FontSize özelliklerine sahip Text bileşik Label denetim gösterilmektedir. Bu özellikler, denetimde yöntemi çağrıldığında Control.Render görünüm durumuna kaydedilir ve bu durumdan alınır.

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

Açıklamalar

Bir sayfa veya denetimin görünüm durumu, bu sayfanın veya denetimin kümülatif özellik değerleri veya görünümüdür. Bu sınıfa Control.ViewState özelliği aracılığıyla erişebilirsiniz. Denetimler temel durum bilgilerini denetim durumunda da depolayabilir, ancak bu bilgiler nesne StateBag olarak depolanmaz.

Bu sınıf, tüm HTML ve Web sunucusu denetimleri için birincil depolama mekanizmasıdır. Öznitelik/değer çiftlerini denetimle ilişkili dizeler olarak depolar. Bu özniteliklerdeki değişiklikleri yalnızca yöntem bir sayfa isteği için yürütüldükten sonra OnInit izler ve değişiklikleri sayfanın veya denetimin görünüm durumuna kaydeder.

Bu sınıf bir sözlük uygular ve buna öğe ekleyebilir veya herhangi bir sözlük nesnesi gibi öğe kaldırabilirsiniz. Sözlükler gibi veri koleksiyonları hakkında daha fazla bilgi için bkz. Koleksiyonlar ve Veri Yapıları.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• Koleksiyonlar ve Veri Yapıları
• ASP.NET Durum Yönetimine Genel Bakış