Control.TrackViewState-Methode

Artikel
08/20/2007

Veranlasst die Nachverfolgung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. Auf dieses Objekt kann über die Control.ViewState-Eigenschaft zugegriffen werden.

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

Syntax

'Declaration
Protected Overridable Sub TrackViewState
'Usage

Me.TrackViewState

protected virtual void TrackViewState ()

protected:
virtual void TrackViewState ()

protected void TrackViewState ()

protected function TrackViewState ()

Hinweise

Diese Methode wird automatisch am Ende des Init-Ereignisses im Lebenszyklus des Serversteuerelements aufgerufen.

Rufen Sie diese Methode beim Entwickeln von auf Vorlagen basierenden, datengebundenen Steuerelementen auf. Diese Methode weist ASP.NET an, Änderungen im Ansichtszustand eines Serversteuerelements zu überwachen. Dies ist beim Überschreiben der Control.DataBind-Methode erforderlich.

Beispiel

Im folgenden Beispiel wird die DataBind-Methode in einem benutzerdefinierten ASP.NET-Serversteuerelement überschrieben. Am Anfang wird die OnDataBinding-Basismethode aufgerufen. Anschließend werden mithilfe der Clear-Methode alle untergeordneten Steuerelemente und mit der ClearChildViewState-Methode alle für diese untergeordneten Steuerelemente gespeicherten Einstellungen für den Ansichtszustand gelöscht. Schließlich wird die ChildControlsCreated-Eigenschaft auf true festgelegt. Dann wird mit der IsTrackingViewState-Eigenschaft des Steuerelements bestimmt, ob die Änderungsverfolgung des Ansichtszustands für das Steuerelement aktiviert ist. Wenn diese nicht aktiviert ist, wird die TrackViewState-Methode aufgerufen.

Public Overrides Sub DataBind()
   MyBase.OnDataBinding(EventArgs.Empty)
   ' Reset the control's state.
   Controls.Clear()
   ' Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   If HasChildViewState Then
      ClearChildViewState()
   End If
   ChildControlsCreated = True
   If Not IsTrackingViewState Then
      TrackViewState()
   End If
End Sub

public override void DataBind() 
{
   base.OnDataBinding(EventArgs.Empty);
   // Reset the control's state.
   Controls.Clear();
   // Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   if (HasChildViewState)
      ClearChildViewState();
   ChildControlsCreated = true;
   if (!IsTrackingViewState)
      TrackViewState();
}

public void DataBind()
{
    super.OnDataBinding(EventArgs.Empty);

    // Reset the control's state.
    get_Controls().Clear();

    // Check for HasChildViewState to avoid unnecessary calls to 
    // ClearChildViewState.
    if (get_HasChildViewState()) {
        ClearChildViewState();
    }
    set_ChildControlsCreated(true);
    if (!(get_IsTrackingViewState())) {
        TrackViewState();
    }
} //DataBind

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
IStateManager
ViewState
LoadViewState
SaveViewState

Freigeben über