StateBag StateBag StateBag StateBag Class

Definizione

Gestisce lo stato di visualizzazione dei controlli server ASP.NET, incluse le pagine.Manages the view state of ASP.NET server controls, including pages. Questa classe non può essere ereditata.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
Ereditarietà
StateBagStateBagStateBagStateBag
Implementazioni

Esempi

L'esempio di codice seguente illustra un composto Label controllo dotato Text e FontSize proprietà.The following code example demonstrates a composite Label control that has Text and FontSize properties. Queste proprietà vengono salvate e recuperate dalla vista stato quando il Control.Render viene chiamato sul controllo.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
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

Commenti

Stato di visualizzazione di una pagina o controllo è la valori delle proprietà cumulativo, o la vista della pagina o controllo.View state for a page or control is the cumulative property values, or view, of that page or control. È possibile accedere a questa classe tramite la Control.ViewState proprietà.You can access this class through the Control.ViewState property. I controlli possono inoltre archiviate informazioni sullo stato essenziale nello stato di controllo, ma che non siano le informazioni archiviate come un StateBag oggetto.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Questa classe è il meccanismo di archiviazione primaria per tutti i controlli server HTML e Web.This class is the primary storage mechanism for all HTML and Web server controls. Archivia le coppie attributo/valore come stringhe associate al controllo.It stores attribute/value pairs as strings associated with the control. Registra le modifiche apportate a questi attributi solo dopo che il OnInit metodo viene eseguito per una richiesta di pagina e Salva le modifiche apportate allo stato di visualizzazione della pagina o del controllo.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.

Questa classe implementa un dizionario ed è possibile aggiungervi elementi o rimuovere elementi da esso come si farebbe con qualsiasi oggetto dizionario.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Per altre informazioni sulle raccolte di dati, ad esempio i dizionari, vedere raccolte e strutture di dati.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Costruttori

StateBag() StateBag() StateBag() StateBag()

Inizializza una nuova istanza della classe StateBag.Initializes a new instance of the StateBag class. È il costruttore predefinito per questa classe.This is the default constructor for this class.

StateBag(Boolean) StateBag(Boolean) StateBag(Boolean) StateBag(Boolean)

Inizializza una nuova istanza della classe StateBag che consente di ignorare la distinzione tra maiuscole e minuscole per i valori di stato memorizzati.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Proprietà

Count Count Count Count

Ottiene il numero di oggetti StateItem presenti nell'oggetto StateBag.Gets the number of StateItem objects in the StateBag object.

Item[String] Item[String] Item[String] Item[String]

Ottiene o imposta il valore di un elemento memorizzato nell'oggetto StateBag.Gets or sets the value of an item stored in the StateBag object.

Keys Keys Keys Keys

Ottiene un insieme di chiavi che rappresentano gli elementi nell'oggetto StateBag.Gets a collection of keys representing the items in the StateBag object.

Values Values Values Values

Ottiene un insieme dei valori dello stato di visualizzazione memorizzati nell'oggetto StateBag.Gets a collection of the view-state values stored in the StateBag object.

Metodi

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Aggiunge un nuovo oggetto StateItem all'oggetto StateBag.Adds a new StateItem object to the StateBag object. Se l'elemento è già presente nell'oggetto StateBag, questo metodo aggiorna il valore dell'elemento.If the item already exists in the StateBag object, this method updates the value of the item.

Clear() Clear() Clear() Clear()

Rimuove tutti gli elementi dall'oggetto StateBag corrente.Removes all items from the current StateBag object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Restituisce un enumeratore che scorre tutte le coppie chiave/valore degli oggetti StateItem archiviati nell'oggetto StateBag.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsItemDirty(String) IsItemDirty(String) IsItemDirty(String) IsItemDirty(String)

Verifica un oggetto StateItem archiviato nell'oggetto StateBag per valutare se ha subito delle modifiche dopo la chiamata del metodo TrackViewState().Checks a StateItem object stored in the StateBag object to evaluate whether it has been modified since the call to TrackViewState().

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Rimuove la coppia chiave/valore specificata dall'oggetto StateBag.Removes the specified key/value pair from the StateBag object.

SetDirty(Boolean) SetDirty(Boolean) SetDirty(Boolean) SetDirty(Boolean)

Imposta lo stato dell'oggetto StateBag, nonché la proprietà Dirty di ciascuno degli oggetti StateItem in esso contenuti.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) SetItemDirty(String, Boolean) SetItemDirty(String, Boolean) SetItemDirty(String, Boolean)

Imposta la proprietà Dirty per l'oggetto StateItem specificato contenuto nell'oggetto StateBag.Sets the Dirty property for the specified StateItem object in the StateBag object.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Per una descrizione di questo membro, vedere CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Per una descrizione di questo membro, vedere IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Per una descrizione di questo membro, vedere SyncRoot.For a description of this member, see SyncRoot.

IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object)

Per una descrizione di questo membro, vedere Add(Object, Object).For a description of this member, see Add(Object, Object).

IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object)

Per una descrizione di questo membro, vedere Contains(Object).For a description of this member, see Contains(Object).

IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize

Per una descrizione di questo membro, vedere IsFixedSize.For a description of this member, see IsFixedSize.

IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly

Per una descrizione di questo membro, vedere IsReadOnly.For a description of this member, see IsReadOnly.

IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object]

Per una descrizione di questo membro, vedere Item[Object].For a description of this member, see Item[Object].

IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object)

Per una descrizione di questo membro, vedere Remove(Object).For a description of this member, see Remove(Object).

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Per una descrizione di questo membro, vedere GetEnumerator().For a description of this member, see GetEnumerator().

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ottiene un valore che indica se viene tenuta traccia delle modifiche apportate allo stato.Gets a value indicating whether state changes are being tracked.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato dell'oggetto StateBag.Restores the previously saved view state of the StateBag object.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Salva le modifiche apportate all'oggetto StateBag dal momento in cui è stato eseguito il postback della pagina al server.Saves the changes to the StateBag object since the time the page was posted back to the server.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Determina il rilevamento delle modifiche allo stato da parte dell'oggetto StateBag in modo che possano essere rese persistenti in tutte le richieste.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Esegue il cast di elementi di un IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un IEnumerable basato su un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche