StateBag Klasa

Definicja

Zarządza stanem widoku kontrolek serwera ASP.NET, w tym strony.Manages the view state of ASP.NET server controls, including pages. Klasa ta nie może być dziedziczona.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
Dziedziczenie
StateBag
Implementuje

Przykłady

Poniższy przykład kodu ilustruje złożony formant Label, który ma właściwości Text i FontSize.The following code example demonstrates a composite Label control that has Text and FontSize properties. Te właściwości są zapisywane i pobierane ze stanu widoku, gdy metoda Control.Render jest wywoływana na formancie.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

Uwagi

Stan widoku strony lub kontrolki to skumulowane wartości właściwości lub widok tej strony lub kontrolki.View state for a page or control is the cumulative property values, or view, of that page or control. Dostęp do tej klasy można uzyskać za pomocą właściwości Control.ViewState.You can access this class through the Control.ViewState property. Kontrolki mogą również przechowywać podstawowe informacje o stanie w stanie kontroli, ale te informacje nie są przechowywane jako obiekt StateBag.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Ta klasa jest podstawowym mechanizmem magazynowania dla wszystkich kontrolek HTML i serwera sieci Web.This class is the primary storage mechanism for all HTML and Web server controls. Przechowuje pary atrybut/wartość jako ciągi skojarzone z kontrolką.It stores attribute/value pairs as strings associated with the control. Śledzi zmiany tych atrybutów dopiero po wykonaniu metody OnInit dla żądania strony i zapisuje zmiany stanu widoku strony lub formantu.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.

Ta klasa implementuje słownik i można do niego dodawać elementy lub usuwać z niego elementy, tak jak każdy obiekt słownika.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Aby uzyskać więcej informacji na temat kolekcji danych, takich jak słowniki, zobacz kolekcje i struktury danych.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Konstruktory

StateBag()

Inicjuje nowe wystąpienie klasy StateBag.Initializes a new instance of the StateBag class. Jest to Konstruktor bez parametrów dla tej klasy.This is the parameterless constructor for this class.

StateBag(Boolean)

Inicjuje nowe wystąpienie klasy StateBag, które umożliwia przechowywanie wartości stanu bez uwzględniania wielkości liter.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Właściwości

Count

Pobiera liczbę StateItem obiektów w obiekcie StateBag.Gets the number of StateItem objects in the StateBag object.

Item[String]

Pobiera lub ustawia wartość elementu przechowywanego w obiekcie StateBag.Gets or sets the value of an item stored in the StateBag object.

Keys

Pobiera kolekcję kluczy reprezentujących elementy w obiekcie StateBag.Gets a collection of keys representing the items in the StateBag object.

Values

Pobiera kolekcję wartości stanu widoku przechowywanych w obiekcie StateBag.Gets a collection of the view-state values stored in the StateBag object.

Metody

Add(String, Object)

Dodaje nowy obiekt StateItem do obiektu StateBag.Adds a new StateItem object to the StateBag object. Jeśli element już istnieje w obiekcie StateBag, ta metoda aktualizuje wartość elementu.If the item already exists in the StateBag object, this method updates the value of the item.

Clear()

Usuwa wszystkie elementy z bieżącego obiektu StateBag.Removes all items from the current StateBag object.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Zwraca moduł wyliczający, który wykonuje iterację wszystkich par klucz/wartość StateItem obiektów przechowywanych w obiekcie StateBag.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IsItemDirty(String)

Sprawdza obiekt StateItem przechowywany w obiekcie StateBag, aby sprawdzić, czy został on zmodyfikowany od czasu wywołania do TrackViewState().Checks a StateItem object stored in the StateBag object to evaluate whether it has been modified since the call to TrackViewState().

MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(String)

Usuwa określoną parę klucz/wartość z obiektu StateBag.Removes the specified key/value pair from the StateBag object.

SetDirty(Boolean)

Ustawia stan obiektu StateBag oraz Właściwość Dirty każdego z obiektów StateItem zawartych w nim.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)

Ustawia właściwość Dirty dla określonego obiektu StateItem w obiekcie StateBag.Sets the Dirty property for the specified StateItem object in the StateBag object.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized

Aby uzyskać opis tego elementu członkowskiego, zobacz IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Aby uzyskać opis tego elementu członkowskiego, zobacz SyncRoot.For a description of this member, see SyncRoot.

IDictionary.Add(Object, Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Add(Object, Object).For a description of this member, see Add(Object, Object).

IDictionary.Contains(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Contains(Object).For a description of this member, see Contains(Object).

IDictionary.IsFixedSize

Aby uzyskać opis tego elementu członkowskiego, zobacz IsFixedSize.For a description of this member, see IsFixedSize.

IDictionary.IsReadOnly

Aby uzyskać opis tego elementu członkowskiego, zobacz IsReadOnly.For a description of this member, see IsReadOnly.

IDictionary.Item[Object]

Aby uzyskać opis tego elementu członkowskiego, zobacz Item[Object].For a description of this member, see Item[Object].

IDictionary.Remove(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Remove(Object).For a description of this member, see Remove(Object).

IEnumerable.GetEnumerator()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetEnumerator().For a description of this member, see GetEnumerator().

IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy zmiany stanu są śledzone.Gets a value indicating whether state changes are being tracked.

IStateManager.LoadViewState(Object)

Przywraca poprzednio zapisany stan widoku obiektu StateBag.Restores the previously saved view state of the StateBag object.

IStateManager.SaveViewState()

Zapisuje zmiany w obiekcie StateBag od momentu, gdy strona została opublikowana z powrotem na serwerze.Saves the changes to the StateBag object since the time the page was posted back to the server.

IStateManager.TrackViewState()

Powoduje, że obiekt StateBag śledzi zmiany w stanie, aby można było go utrwalać między żądaniami.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też