StateBag Klasse

Definition

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

Object

StateBag

Implementiert

ICollection IDictionary IEnumerable IStateManager

Beispiele

Im folgenden Codebeispiel wird ein zusammengesetztes Label Steuerelement mit Text Eigenschaften und FontSize veranschaulicht. Diese Eigenschaften werden im Ansichtszustand gespeichert und abgerufen, wenn die Control.Render -Methode für das -Steuerelement aufgerufen wird.

// 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

Hinweise

Der Ansichtsstatus für eine Seite oder ein Steuerelement ist die kumulativen Eigenschaftswerte oder Ansichten dieser Seite oder eines Steuerelements. Sie können über die Control.ViewState -Eigenschaft auf diese Klasse zugreifen. Steuerelemente können auch wichtige Zustandsinformationen im Steuerungszustand StateBag speichern, aber diese Informationen werden nicht als Objekt gespeichert.

Diese Klasse ist der primäre Speichermechanismus für alle HTML- und Webserversteuerelemente. Sie speichert Attribut-Wert-Paare als Zeichenfolgen, die dem Steuerelement zugeordnet sind. Änderungen an diesen Attributen werden erst nachverfolgt, nachdem die OnInit Methode für eine Seitenanforderung ausgeführt wurde, und speichert die Änderungen im Ansichtszustand der Seite oder des Steuerelements.

Diese Klasse implementiert ein Wörterbuch, und Sie können wie jedes Wörterbuchobjekt Elemente hinzufügen oder elemente daraus entfernen. Weitere Informationen zu Datensammlungen, z. B. Wörterbücher, finden Sie unter Sammlungen und Datenstrukturen.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• IStateManager
• IDictionary
• ViewState
• AttributeCollection
• Sammlungen und Datenstrukturen
• Übersicht über die ASP.NET-Zustandsverwaltung