Control.DataBind Méthode

public:
 virtual void DataBind();

public virtual void DataBind ();

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

Public Overridable Sub DataBind ()

Exemples

L’exemple suivant remplace la DataBind méthode dans un contrôle serveur personnalisé ASP.NET. Il commence par appeler la méthode de base OnDataBinding , puis utilise la ControlCollection.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 et le contrôle est invité à suivre les modifications apportées à l’état d’affichage des contrôles nouvellement créés avec la TrackViewState méthode . Il s’agit d’une technique courante lors de la liaison de données à un contrôle pour garantir que les nouvelles données ne sont pas en conflit avec les données stockées à partir d’un appel de méthode précédent DataBind .

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

Utilisez cette méthode pour lier des données d’une source à un contrôle serveur. Cette méthode est couramment utilisée après la récupération d’un jeu de données via une requête de base de données. La plupart des contrôles effectuent la liaison de données automatiquement, ce qui signifie que vous n’avez généralement pas besoin d’appeler cette méthode explicitement.

Cette méthode est généralement remplacée lorsque vous créez un contrôle lié aux données avec modèle personnalisé. Pour plus d’informations, consultez How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls. Lorsqu’elle est appelée sur un contrôle serveur, cette méthode résout toutes les expressions de liaison de données dans le contrôle serveur et dans l’un de ses contrôles enfants.

Voir aussi

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Développement de contrôles serveur ASP.NET personnalisés
• Vue d’ensemble du cycle de vie des pages ASP.NET

protected:
 virtual void DataBind(bool raiseOnDataBinding);

protected virtual void DataBind (bool raiseOnDataBinding);

abstract member DataBind : bool -> unit
override this.DataBind : bool -> unit

Protected Overridable Sub DataBind (raiseOnDataBinding As Boolean)

Paramètres

Remarques

Utilisez la Control.DataBind(Boolean) méthode dans un scénario lorsque votre contrôle personnalisé remplace la DataBind méthode et implémente l’interface IDataItemContainer . Dans ce scénario, le contrôle personnalisé appelle la Control.DataBind(Boolean) méthode avec raiseOnDataBinding défini sur false pour s’assurer que la méthode de la classe de DataBind base est appelée.

La Control.DataBind() méthode appelle la Control.DataBind(Boolean) méthode avec raiseOnDataBinding la valeur définie sur true.

Voir aussi

• DataBinding
• DataBindChildren()
• Vue d’ensemble du cycle de vie des pages ASP.NET