StateBag Třída

Definice

Spravuje stav zobrazení ovládacích prvků serveru ASP.NET, včetně stránek.Manages the view state of ASP.NET server controls, including pages. Tuto třídu nelze zdědit.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
Dědičnost
StateBag
Implementuje

Příklady

Následující příklad kódu ukazuje složený Label ovládací prvek, který má Text a FontSize Vlastnosti.The following code example demonstrates a composite Label control that has Text and FontSize properties. Tyto vlastnosti jsou uloženy do a načteny ze stavu zobrazení, pokud Control.Render je metoda volána na ovládacím prvku.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

Poznámky

Stav zobrazení stránky nebo ovládacího prvku jsou hodnoty kumulativních vlastností nebo zobrazení této stránky nebo ovládacího prvku.View state for a page or control is the cumulative property values, or view, of that page or control. K této třídě můžete přistupovat prostřednictvím Control.ViewState Vlastnosti.You can access this class through the Control.ViewState property. Ovládací prvky mohou také ukládat podstatné informace o stavu ve stavu řízení, ale tyto informace nejsou uloženy jako StateBag objekt.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Tato třída je primárním mechanismem úložiště pro všechny ovládací prvky HTML a webový server.This class is the primary storage mechanism for all HTML and Web server controls. Ukládá páry atribut/hodnota jako řetězce přidružené k ovládacímu prvku.It stores attribute/value pairs as strings associated with the control. Sleduje změny těchto atributů až po OnInit provedení metody pro požadavek stránky a uloží změny do stavu zobrazení stránky nebo ovládacího prvku.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.

Tato třída implementuje slovník a můžete do něj přidat položky nebo z něj odebrat položky, stejně jako jakýkoli objekt Dictionary.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Další informace o kolekcích dat, jako jsou například slovníky, najdete v tématu kolekce a datové struktury.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Konstruktory

StateBag()

Inicializuje novou instanci StateBag třídy.Initializes a new instance of the StateBag class. Toto je konstruktor bez parametrů pro tuto třídu.This is the parameterless constructor for this class.

StateBag(Boolean)

Inicializuje novou instanci StateBag třídy, která umožňuje, aby hodnoty uložených stavů byly nerozlišovat velká a malá písmena.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Vlastnosti

Count

Získá počet StateItem objektů v StateBag objektu.Gets the number of StateItem objects in the StateBag object.

Item[String]

Získá nebo nastaví hodnotu položky uložené v StateBag objektu.Gets or sets the value of an item stored in the StateBag object.

Keys

Získá kolekci klíčů reprezentujících položky v StateBag objektu.Gets a collection of keys representing the items in the StateBag object.

Values

Získá kolekci hodnot stavu zobrazení uložených v StateBag objektu.Gets a collection of the view-state values stored in the StateBag object.

Metody

Add(String, Object)

Přidá nový StateItem objekt do StateBag objektu.Adds a new StateItem object to the StateBag object. Pokud položka v objektu již existuje StateBag , tato metoda aktualizuje hodnotu položky.If the item already exists in the StateBag object, this method updates the value of the item.

Clear()

Odebere všechny položky z aktuálního StateBag objektu.Removes all items from the current StateBag object.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetEnumerator()

Vrátí enumerátor, který projde všechny páry klíč/hodnota StateItem objektů uložených v StateBag objektu.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
IsItemDirty(String)

Kontroluje StateItem objekt uložený v StateBag objektu, aby vyhodnotil, zda byl od volání metody změněn TrackViewState() .Checks a StateItem object stored in the StateBag object to evaluate whether it has been modified since the call to TrackViewState().

MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
Remove(String)

Odstraní zadaný pár klíč/hodnota z StateBag objektu.Removes the specified key/value pair from the StateBag object.

SetDirty(Boolean)

Nastaví stav StateBag objektu i Dirty vlastnost každého z StateItem objektů obsažených v něm.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)

Nastaví Dirty vlastnost pro zadaný StateItem objekt v StateBag objektu.Sets the Dirty property for the specified StateItem object in the StateBag object.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Explicitní implementace rozhraní

ICollection.CopyTo(Array, Int32)

Popis tohoto člena naleznete v tématu CopyTo(Array, Int32) .For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized

Popis tohoto člena naleznete v tématu IsSynchronized .For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Popis tohoto člena naleznete v tématu SyncRoot .For a description of this member, see SyncRoot.

IDictionary.Add(Object, Object)

Popis tohoto člena naleznete v tématu Add(Object, Object) .For a description of this member, see Add(Object, Object).

IDictionary.Contains(Object)

Popis tohoto člena naleznete v tématu Contains(Object) .For a description of this member, see Contains(Object).

IDictionary.IsFixedSize

Popis tohoto člena naleznete v tématu IsFixedSize .For a description of this member, see IsFixedSize.

IDictionary.IsReadOnly

Popis tohoto člena naleznete v tématu IsReadOnly .For a description of this member, see IsReadOnly.

IDictionary.Item[Object]

Popis tohoto člena naleznete v tématu Item[Object] .For a description of this member, see Item[Object].

IDictionary.Remove(Object)

Popis tohoto člena naleznete v tématu Remove(Object) .For a description of this member, see Remove(Object).

IEnumerable.GetEnumerator()

Popis tohoto člena naleznete v tématu GetEnumerator() .For a description of this member, see GetEnumerator().

IStateManager.IsTrackingViewState

Načte hodnotu, která označuje, zda jsou sledovány změny stavu.Gets a value indicating whether state changes are being tracked.

IStateManager.LoadViewState(Object)

Obnoví dříve uložený stav zobrazení StateBag objektu.Restores the previously saved view state of the StateBag object.

IStateManager.SaveViewState()

Uloží změny StateBag objektu od okamžiku, kdy byla stránka odeslána zpět na server.Saves the changes to the StateBag object since the time the page was posted back to the server.

IStateManager.TrackViewState()

Způsobí StateBag , že objekt bude sledovat změny stavu, aby mohl být trvale v rámci požadavků.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Metody rozšíření

Cast<TResult>(IEnumerable)

Přetypování prvky IEnumerable na zadaný typ.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje prvky IEnumerable založené na zadaném typu.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Povoluje paralelní zpracování dotazu.Enables parallelization of a query.

AsQueryable(IEnumerable)

Převede IEnumerable na IQueryable .Converts an IEnumerable to an IQueryable.

Platí pro

Viz také