Control.TrackViewState Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Provoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété ViewState.

protected:
 virtual void TrackViewState();

protected virtual void TrackViewState ();

abstract member TrackViewState : unit -> unit
override this.TrackViewState : unit -> unit

Protected Overridable Sub TrackViewState ()

Exemples

L’exemple suivant remplace la DataBind méthode dans un contrôle serveur de ASP.NET personnalisé. Il commence par appeler la méthode de base OnDataBinding , puis utilise la Clear méthode pour supprimer tous les contrôles enfants et la ClearChildViewState méthode pour supprimer tous les paramètres d’état d’affichage enregistrés pour ces contrôles enfants. Enfin, la ChildControlsCreated propriété est définie sur true. Le contrôle utilise ensuite la propriété pour déterminer si le IsTrackingViewState suivi des modifications de l’état d’affichage est activé pour le contrôle. Si elle n’est pas activée, la TrackViewState méthode est appelée.

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 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

Remarques

Cette méthode est appelée automatiquement à la fin de l’événement Init dans le cycle de vie du contrôle serveur.

Appelez cette méthode lorsque vous développez des contrôles liés aux données avec modèle. Cette méthode alerte ASP.NET pour surveiller les modifications apportées à l’état d’affichage d’un contrôle serveur, ce qui est nécessaire lorsque vous remplacez la Control.DataBind méthode.

Voir aussi

• IStateManager
• ViewState
• LoadViewState(Object)
• SaveViewState()