StateBag Classe

Définition

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

Héritage

Object

StateBag

Implémente

ICollection IDictionary IEnumerable IStateManager

Exemples

L’exemple de code suivant illustre un contrôle composite Label qui a Text des propriétés et FontSize . Ces propriétés sont enregistrées et récupérées dans l’état d’affichage lorsque la Control.Render méthode est appelée sur le contrôle.

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

Remarques

L’état d’affichage d’une page ou d’un contrôle correspond aux valeurs de propriété cumulatives de cette page ou contrôle. Vous pouvez accéder à cette classe via la Control.ViewState propriété . Les contrôles peuvent également stocker des informations d’état essentielles dans un état de contrôle, mais ces informations ne sont pas stockées en tant qu’objet StateBag .

Cette classe est le mécanisme de stockage principal pour tous les contrôles HTML et serveur web. Il stocke les paires attribut/valeur sous forme de chaînes associées au contrôle. Il effectue le suivi des modifications apportées à ces attributs uniquement après l’exécution de la OnInit méthode pour une demande de page et enregistre les modifications apportées à l’état d’affichage de la page ou du contrôle.

Cette classe implémente un dictionnaire, et vous pouvez y ajouter des éléments ou en supprimer des éléments comme vous le feriez pour n’importe quel objet de dictionnaire. Pour plus d’informations sur les collections de données, telles que les dictionnaires, consultez Collections et structures de données.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à

Voir aussi

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• Collections et structures de données
• Vue d’ensemble de la gestion de l’état ASP.NET