Control.DataBind Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.
Surcharges
| Nom | Description |
|---|---|
| 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 -> unitPublic Overridable Sub DataBind ()Exemples
L’exemple suivant remplace la DataBind méthode dans un contrôle serveur 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 les paramètres d’état d’affichage enregistrés pour ces contrôles enfants. Enfin, la ChildControlsCreated propriété est définie 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 s’assurer 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 avoir récupéré un jeu de données via une requête de base de données. La plupart des contrôles effectuent automatiquement une liaison de données, 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 substituée lorsque vous créez un contrôle personnalisé lié aux données avec modèle. 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 de page ASP.NET
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 -> unitProtected 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 la méthode définie raiseOnDataBinding pour false 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.
Note
L’appel de la Control.DataBind(Boolean) méthode avec raiseOnDataBinding défini pour false provoquer la liaison de données entre les contrôles enfants et la Control.DataBind() méthode.
