StateBag Classe

Définition

Gère l'état d'affichage des contrôles serveur ASP.NET, y compris les pages.Manages the view state of ASP.NET server controls, including pages. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
StateBag
Implémente

Exemples

L’exemple de code suivant illustre un contrôle composite Label qui a des propriétés Text et FontSize.The following code example demonstrates a composite Label control that has Text and FontSize properties. Ces propriétés sont enregistrées et récupérées à partir de l’état d’affichage lorsque la méthode Control.Render est appelée sur le contrôle.These properties are saved to and retrieved from view state when the Control.Render method is called on the control.

// 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é cumulées, ou vue, de cette page ou de ce contrôle.View state for a page or control is the cumulative property values, or view, of that page or control. Vous pouvez accéder à cette classe via la propriété Control.ViewState.You can access this class through the Control.ViewState property. Les contrôles peuvent également stocker des informations d’État essentielles dans l’état du contrôle, mais ces informations ne sont pas stockées en tant qu’objet StateBag.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Cette classe est le mécanisme de stockage principal pour tous les contrôles de serveur Web et HTML.This class is the primary storage mechanism for all HTML and Web server controls. Elle stocke les paires attribut/valeur sous forme de chaînes associées au contrôle.It stores attribute/value pairs as strings associated with the control. Il effectue le suivi des modifications apportées à ces attributs uniquement après l’exécution de la méthode OnInit pour une demande de page et enregistre les modifications apportées à l’état d’affichage de la page ou du contrôle.It tracks changes to these attributes only after the OnInit method is executed for a page request, and saves the changes to the page's or control's view state.

Cette classe implémente un dictionnaire, et vous pouvez y ajouter des éléments ou en supprimer, comme vous le feriez pour n’importe quel objet dictionnaire.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Pour plus d’informations sur les collections de données, telles que les dictionnaires, consultez collections et structures de données.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Constructeurs

StateBag()

Initialise une nouvelle instance de la classe StateBag.Initializes a new instance of the StateBag class. Il s’agit du constructeur sans paramètre de cette classe.This is the parameterless constructor for this class.

StateBag(Boolean)

Initialise une nouvelle instance de la classe StateBag qui permet aux valeurs d'état stockées de ne pas respecter la casse.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Propriétés

Count

Obtient le nombre d'objets StateItem de l'objet StateBag.Gets the number of StateItem objects in the StateBag object.

Item[String]

Obtient ou définit la valeur d'un élément stocké dans l'objet StateBag.Gets or sets the value of an item stored in the StateBag object.

Keys

Obtient une collection de clés représentant les éléments de l'objet StateBag.Gets a collection of keys representing the items in the StateBag object.

Values

Obtient une collection des valeurs d'état d'affichage stockées dans l'objet StateBag.Gets a collection of the view-state values stored in the StateBag object.

Méthodes

Add(String, Object)

Ajoute un nouvel objet StateItem à l'objet StateBag.Adds a new StateItem object to the StateBag object. Si l'élément existe déjà dans l'objet StateBag, cette méthode met à jour la valeur de l'élément.If the item already exists in the StateBag object, this method updates the value of the item.

Clear()

Supprime tous les éléments de l'objet StateBag en cours.Removes all items from the current StateBag object.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un énumérateur qui itère au sein de toutes les paires clé/valeur des objets StateItem stockés dans StateBag.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IsItemDirty(String)

Contrôle un objet StateItem stocké dans l'objet StateBag pour évaluer s'il a été modifié depuis l'appel à TrackViewState().Checks a StateItem object stored in the StateBag object to evaluate whether it has been modified since the call to TrackViewState().

MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Remove(String)

Supprime la paire clé/valeur spécifiée de l'objet StateBag.Removes the specified key/value pair from the StateBag object.

SetDirty(Boolean)

Définit l’état de l’objet StateBag ainsi que la propriété Dirty de chaque objet StateItem contenu.Sets the state of the StateBag object as well as the Dirty property of each of the StateItem objects contained by it.

SetItemDirty(String, Boolean)

Définit la propriété Dirty pour l'objet StateItem spécifié dans l'objet StateBag.Sets the Dirty property for the specified StateItem object in the StateBag object.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Pour obtenir une description de ce membre, consultez CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized

Pour obtenir une description de ce membre, consultez IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Pour obtenir une description de ce membre, consultez SyncRoot.For a description of this member, see SyncRoot.

IDictionary.Add(Object, Object)

Pour obtenir une description de ce membre, consultez Add(Object, Object).For a description of this member, see Add(Object, Object).

IDictionary.Contains(Object)

Pour obtenir une description de ce membre, consultez Contains(Object).For a description of this member, see Contains(Object).

IDictionary.IsFixedSize

Pour obtenir une description de ce membre, consultez IsFixedSize.For a description of this member, see IsFixedSize.

IDictionary.IsReadOnly

Pour obtenir une description de ce membre, consultez IsReadOnly.For a description of this member, see IsReadOnly.

IDictionary.Item[Object]

Pour obtenir une description de ce membre, consultez Item[Object].For a description of this member, see Item[Object].

IDictionary.Remove(Object)

Pour obtenir une description de ce membre, consultez Remove(Object).For a description of this member, see Remove(Object).

IEnumerable.GetEnumerator()

Pour obtenir une description de ce membre, consultez GetEnumerator().For a description of this member, see GetEnumerator().

IStateManager.IsTrackingViewState

Obtient une valeur indiquant si les modifications d’état sont suivies.Gets a value indicating whether state changes are being tracked.

IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment de l'objet StateBag.Restores the previously saved view state of the StateBag object.

IStateManager.SaveViewState()

Enregistre les modifications apportées à l’objet StateBag depuis la publication de la page sur le serveur.Saves the changes to the StateBag object since the time the page was posted back to the server.

IStateManager.TrackViewState()

Conduit l’objet StateBag à suivre les modifications apportées à son état pour rester persistant dans plusieurs requêtes.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi