StateBag StateBag StateBag StateBag Class

Definition

Verwaltet den Ansichtszustand von ASP.NET-Serversteuerelementen, einschließlich Seiten.Manages the view state of ASP.NET server controls, including pages. Diese Klasse kann nicht vererbt werden.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
Vererbung
StateBagStateBagStateBagStateBag
Implementiert

Beispiele

Das folgende Codebeispiel veranschaulicht ein zusammen Label gesetztes Steuer Text Element FontSize mit-und-Eigenschaften.The following code example demonstrates a composite Label control that has Text and FontSize properties. Diese Eigenschaften werden im Ansichts Zustand gespeichert und abgerufen, wenn Control.Render die-Methode für das-Steuerelement aufgerufen wird.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

Hinweise

Der Ansichts Zustand für eine Seite oder ein Steuerelement ist die kumulierte Eigenschaftswerte (oder Ansicht) dieser Seite bzw. des Steuer Elements.View state for a page or control is the cumulative property values, or view, of that page or control. Sie können auf diese Klasse über die Control.ViewState -Eigenschaft zugreifen.You can access this class through the Control.ViewState property. Steuerelemente können auch wichtige Zustandsinformationen im Steuerelement Zustand speichern. diese Informationen werden jedoch nicht als StateBag -Objekt gespeichert.Controls can also store essential state information in control state, but that information is not stored as a StateBag object.

Diese Klasse ist der primäre Speichermechanismus für alle HTML-und Webserver-Steuerelemente.This class is the primary storage mechanism for all HTML and Web server controls. Attribute/Wert-Paare werden als Zeichen folgen gespeichert, die dem Steuerelement zugeordnet sind.It stores attribute/value pairs as strings associated with the control. Änderungen an diesen Attributen werden erst nachverfolgt, OnInit nachdem die-Methode für eine Seiten Anforderung ausgeführt wurde, und die Änderungen am Ansichts Zustand der Seite oder des Steuer Elements werden gespeichert.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.

Diese Klasse implementiert ein Wörterbuch, und Sie können Elemente hinzufügen oder Elemente daraus entfernen, wie es bei jedem beliebigen Wörterbuch Objekt der Fall wäre.This class implements a dictionary, and you can add items to it or remove items from it as you would any dictionary object. Weitere Informationen zu Datensammlungen, z. b. Wörterbücher, finden Sie unter Sammlungen und Datenstrukturen.For more information about data collections, such as dictionaries, see Collections and Data Structures.

Konstruktoren

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

Initialisiert eine neue Instanz der StateBag-Klasse.Initializes a new instance of the StateBag class. Dies ist der parameterlose Konstruktor für diese Klasse.This is the parameterless constructor for this class.

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

Initialisiert eine neue Instanz der StateBag-Klasse, die zulässt, dass bei gespeicherten Zustandswerten die Groß- und Kleinschreibung nicht berücksichtigt wird.Initializes a new instance of the StateBag class that allows stored state values to be case-insensitive.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der StateItem-Objekte im StateBag-Objekt ab.Gets the number of StateItem objects in the StateBag object.

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

Ruft den Wert eines im StateBag-Objekt gespeicherten Elements ab oder legt diesen fest.Gets or sets the value of an item stored in the StateBag object.

Keys Keys Keys Keys

Ruft eine Auflistung der Schlüssel ab, die die Elemente im StateBag-Objekt darstellen.Gets a collection of keys representing the items in the StateBag object.

Values Values Values Values

Ruft eine Auflistung von im StateBag-Objekt gespeicherten Ansichtszustandswerten ab.Gets a collection of the view-state values stored in the StateBag object.

Methoden

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

Fügt dem StateItem-Objekt ein neues StateBag-Objekt hinzu.Adds a new StateItem object to the StateBag object. Wenn das Element bereits im StateBag-Objekt vorhanden ist, aktualisiert diese Methode den Wert des Elements.If the item already exists in the StateBag object, this method updates the value of the item.

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

Entfernt alle Elemente aus dem aktuellen StateBag-Objekt.Removes all items from the current StateBag object.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt einen Enumerator zurück, der alle Schlüssel-Wert-Paare des im StateItem-Objekt gespeicherten StateBag-Objekts durchläuft.Returns an enumerator that iterates over all the key/value pairs of the StateItem objects stored in the StateBag object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Überprüft ein im StateItem-Objekt gespeichertes StateBag-Objekt, um auszuwerten, ob es seit dem Aufruf von TrackViewState() geändert wurde.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()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Entfernt das angegebene Schlüssel-Wert-Paar aus dem StateBag-Objekt.Removes the specified key/value pair from the StateBag object.

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

Legt sowohl den Status des StateBag-Objekts als auch die Dirty-Eigenschaft der einzelnen darin enthaltenen StateItem-Objekte fest.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)

Legt die Dirty-Eigenschaft für das angegebene StateItem-Objekt im StateBag-Objekt fest.Sets the Dirty property for the specified StateItem object in the StateBag object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Eine Beschreibung dieses Elements finden Sie unter CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

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

Eine Beschreibung dieses Elements finden Sie unter IsSynchronized.For a description of this member, see IsSynchronized.

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

Eine Beschreibung dieses Elements finden Sie unter 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)

Eine Beschreibung dieses Elements finden Sie unter 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)

Eine Beschreibung dieses Members finden Sie unter Contains(Object).For a description of this member, see Contains(Object).

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

Eine Beschreibung dieses Elements finden Sie unter IsFixedSize.For a description of this member, see IsFixedSize.

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

Eine Beschreibung dieses Members finden Sie unter IsReadOnly.For a description of this member, see IsReadOnly.

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

Eine Beschreibung dieses Elements finden Sie unter Item[Object].For a description of this member, see Item[Object].

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

Eine Beschreibung dieses Members finden Sie unter Remove(Object).For a description of this member, see Remove(Object).

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

Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().For a description of this member, see GetEnumerator().

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

Ruft einen Wert ab, der anzeigt, ob Zustandsänderungen verfolgt werden.Gets a value indicating whether state changes are being tracked.

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

Stellt den zuvor gespeicherten Ansichtszustand des StateBag-Objekts wieder her.Restores the previously saved view state of the StateBag object.

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

Speichert die Änderungen am StateBag-Objekt ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.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()

Bewirkt, dass das StateBag-Objekt Änderungen an seinem Zustand nachverfolgt, sodass es anforderungsübergreifend beibehalten werden kann.Causes the StateBag object to track changes to its state so that it can be persisted across requests.

Erweiterungsmethoden

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

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

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

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

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

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

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

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch