Control.EnableViewState-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property EnableViewState As Boolean
'Usage
Dim instance As Control
Dim value As Boolean

value = instance.EnableViewState

instance.EnableViewState = value

[ThemeableAttribute(false)] 
public virtual bool EnableViewState { get; set; }

[ThemeableAttribute(false)] 
public:
virtual property bool EnableViewState {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_EnableViewState ()

/** @property */
public void set_EnableViewState (boolean value)

public function get EnableViewState () : boolean

public function set EnableViewState (value : boolean)

Eigenschaftenwert

true, wenn das Serversteuerelement seinen Ansichtszustand beibehält, andernfalls false. Der Standardwert ist true.

Hinweise

Der Ansichtszustand für das Serversteuerelement muss aktiviert werden, damit sein Zustand über HTTP-Anforderungen hinweg beibehalten wird.

Der Ansichtszustand eines Serversteuerelements besteht aus der Ansammlung aller zugehörigen Eigenschaftenwerte. Damit diese Werte über HTTP-Anforderungen hinweg erhalten bleiben, verwendet ASP.NET zum Speichern dieser Eigenschaftenwerte eine Instanz der StateBag-Klasse. Die Werte werden dann bei der Verarbeitung nachfolgender Anforderungen als Variable an ein ausgeblendetes Feld übergeben. Weitere Informationen über den Ansichtszustand finden Sie unter Übersicht über den Ansichtszustand.

Unter Umständen kann es sinnvoll sein, den Ansichtszustand zu deaktivieren, besonders wenn die Leistung der Anwendung verbessert werden soll. Wenn Sie z. B. eine Datenbankanforderung in ein Serversteuerelement laden, legen Sie diese Eigenschaft auf false fest. Andernfalls wird unnötig Prozessorzeit beansprucht, indem der Ansichtszustand in das Serversteuerelement geladen wird, der von der Datenbankabfrage ohnehin überschrieben wird. Wenn EnableViewState gleich false ist, können Sie Eigenschafteninformationen mithilfe des Steuerelementzustands beibehalten, die spezifisch für ein Steuerelement sind und nicht ausgeschaltet werden können, z. B. die Ansichtszustandseigenschaft. Weitere Informationen zum Unterschied zwischen dem Steuerelementzustand und dem Ansichtszustand finden Sie unter Beispiel für den Vergleich zwischen Steuerelementzustand und Ansichtszustand. Informationen zu den neuen Zustandsverwaltungsfunktionen in ASP.NET 2.0 finden Sie unter Neues in der ASP.NET-Zustandsverwaltung.

Weitere Informationen zum deklarative Aktivieren und Deaktivieren des Ansichtszustands für eine ASP.NET-Seite finden Sie unter @ Page.

Beispiel

Im folgenden Beispiel wird die EnableViewState-Eigenschaft auf false festgelegt.

Sub Page_Load(sender As Object, e As System.EventArgs)
   DataBind()
   ' Set EnableViewState to false to disable saving of view state 
   ' information.
   myControl.EnableViewState = False
   If Not IsPostBack Then
      display.Enabled = False
   End If 
End Sub

void Page_Load(object sender, System.EventArgs e)
{
      DataBind();
      // Set EnableViewState to false to disable saving of view state 
      // information.
      myControl.EnableViewState = false;
      if (!IsPostBack)
         display.Enabled = false;
      
}

void Page_Load(Object sender, System.EventArgs e)
{
    DataBind();
    // Set EnableViewState to false to disable saving of view state 
    // information.
    myControl.set_EnableViewState(false);
    if (!(get_IsPostBack())) {
        display.set_Enabled(false);
   }
} //Page_Load

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace
ViewState
LoadViewState
SaveViewState
IsViewStateEnabled

Weitere Ressourcen

@ Page
Übersicht über den Lebenszyklus von ASP.NET-Seiten
ASP.NET-Zustandsverwaltung
Übersicht über die ASP.NET-Zustandsverwaltung
Beispiel für den Vergleich zwischen Steuerelementzustand und Ansichtszustand
Neues in der ASP.NET-Zustandsverwaltung

Freigeben über