Control.DataBind Méthode

Définition

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

Surcharges

DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

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 de ASP.NET personnalisé. 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 et le contrôle est chargé true de 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 une 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 et 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

S’applique à

DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

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

raiseOnDataBinding
Boolean

true si l'événement DataBinding est déclenché ; sinon, false.

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.

Notes

L’appel de la Control.DataBind(Boolean) méthode avec raiseOnDataBinding défini sur false fait que tous les contrôles enfants sont liés aux données avec la Control.DataBind() méthode .

Voir aussi

S’applique à