Control.ViewState Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč více požadavky na stejnou stránku.
protected:
virtual property System::Web::UI::StateBag ^ ViewState { System::Web::UI::StateBag ^ get(); };
[System.ComponentModel.Browsable(false)]
protected virtual System.Web.UI.StateBag ViewState { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ViewState : System.Web.UI.StateBag
Protected Overridable ReadOnly Property ViewState As StateBag
Hodnota vlastnosti
Instance StateBag třídy, která obsahuje informace o stavu zobrazení ovládacího prvku serveru.
- Atributy
Příklady
Následující příklad ukazuje implementaci Text
vlastnosti, která ukládá a načte jeho hodnotu z jeho vlastnosti ovládacího prvku ViewState .
// 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;
}
}
' 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
Poznámky
Stav zobrazení ovládacího prvku serveru je akumulace všech hodnot vlastností. Chcete-li zachovat tyto hodnoty napříč požadavky HTTP, ASP.NET server ovládací prvky používají tuto vlastnost, což je instance StateBag třídy, k uložení hodnot vlastností. Hodnoty se pak předávají jako proměnná do skrytého vstupního elementu HTML při zpracování následných požadavků. Další informace o ukládání stavu zobrazení řízení serveru najdete v tématu ASP.NET Přehled správy stavu.
Stav zobrazení je ve výchozím nastavení povolený pro všechny ovládací prvky serveru, ale existují okolnosti, za kterých ho budete chtít zakázat. Další informace najdete v tématu ASP.NET Přehled výkonu.
Informace o slovníkech a jejich použití najdete v tématu Kolekce a datové struktury.