Control.IsTrackingViewState-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.

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

Syntax

'Declaration
Protected ReadOnly Property IsTrackingViewState As Boolean
'Usage
Dim value As Boolean

value = Me.IsTrackingViewState

protected bool IsTrackingViewState { get; }

protected:
property bool IsTrackingViewState {
    bool get ();
}

/** @property */
protected boolean get_IsTrackingViewState ()

protected function get IsTrackingViewState () : boolean

Eigenschaftenwert

true, wenn das Steuerelement für das Speichern seines Zustands markiert ist, andernfalls false.

Hinweise

Ein Beispiel für ein benutzerdefiniertes Serversteuerelement, das diese Eigenschaft verwendet, finden Sie unter Beispiel für ein vorlagenbasiertes Serversteuerelement.

Beispiel

Im folgenden Beispiel wird die DataBind-Methode in einem benutzerdefinierten ASP.NET-Serversteuerelement überschrieben. Am Anfang wird die grundlegende OnDataBinding-Methode aufgerufen. Anschließend werden mithilfe der ControlCollection.ControlCollection.Clear-Methode alle untergeordneten Steuerelemente gelöscht und mit der ClearChildViewState-Methode jegliche 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
ViewState
LoadViewState
SaveViewState

Freigeben über