WebControl.SaveViewState-Methode

Artikel
08/20/2007

Speichert jeden Zustand, der nach dem Aufruf der TrackViewState-Methode geändert wurde.

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

Syntax

'Declaration
Protected Overrides Function SaveViewState As Object
'Usage
Dim returnValue As Object

returnValue = Me.SaveViewState

protected override Object SaveViewState ()

protected:
virtual Object^ SaveViewState () override

protected Object SaveViewState ()

protected override function SaveViewState () : Object

Rückgabewert

Ein Objekt, das die Änderungen des Ansichtszustands des Steuerelements enthält, andernfalls NULL (Nothing in Visual Basic), wenn dem Objekt kein Ansichtszustand zugeordnet ist.

Hinweise

Die SaveViewState-Methode wird vorwiegend von Steuerelemententwicklern verwendet.

Beim Ansichtszustand handelt es sich um die kumulierten Werte der Eigenschaften für ein Serversteuerelement. Diese Werte werden automatisch in der ViewState-Eigenschaft für das Serversteuerelement platziert, die eine Instanz der StateBag-Klasse darstellt. Der Wert der ViewState-Eigenschaft wird dann nach der Zustandsspeicherungsstufe im Lebenszyklus des Serversteuerelements für ein Zeichenfolgenobjekt beibehalten. Weitere Informationen finden Sie unter Übersicht über den Lebenszyklus von ASP.NET-Seiten.

Wenn der Ansichtszustand gespeichert wird, wird das Zeichenfolgenobjekt an den Client als Variable zurückgegeben, die in einem ausgeblendeten input-HTML-Element gespeichert wird. Wenn Sie benutzerdefinierte Serversteuerelemente erstellen, können Sie die Effizienz steigern, indem Sie die SaveViewState-Methode überschreiben und die ViewState-Eigenschaft für das Serversteuerelement ändern. Weitere Informationen finden Sie unter ASP.NET-Zustandsverwaltung.

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

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace
ViewState
IsTrackingViewState

Weitere Ressourcen

Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen
Beispiel für den Vergleich zwischen Steuerelementzustand und Ansichtszustand
ASP.NET-Zustandsverwaltung
Übersicht über den Lebenszyklus von ASP.NET-Seiten

Freigeben über