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 プロパティを持つText複合Labelコントロールを示しています。 これらのプロパティは、 コントロールで メソッドが呼び出されると、 に 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 および Web サーバー コントロールのプライマリ ストレージ メカニズムです。 属性と値のペアは、コントロールに関連付けられた文字列として格納されます。 これらの属性の変更は、ページ要求に OnInit 対して メソッドが実行された後にのみ追跡され、変更がページまたはコントロールのビュー ステートに保存されます。

このクラスは辞書を実装し、辞書オブジェクトと同様に項目を追加したり、そこから項目を削除したりできます。 ディクショナリなどのデータ コレクションの詳細については、「 コレクションとデータ構造」を参照してください。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象

こちらもご覧ください

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• コレクションとデータ構造体
• ASP.NET 状態管理の概要