Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Control.DataBind, méthode

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

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)

public virtual void DataBind()

Utilisez cette méthode pour lier les données d'une source à un contrôle serveur. Cette méthode est couramment utilisée après la récupération d'un groupe de données à l'aide d'une requête de base de données. La plupart des contrôles exécutent automatiquement une liaison de données, ce qui signifie que généralement vous n'avez pas besoin d'appeler cette méthode de manière explicite.

Cette méthode est couramment substituée lorsque vous créez un contrôle lié aux données personnalisés et basé sur un modèle. Pour plus d’informations, consultez How to: Create Templated 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 tous ses contrôles enfants.

L'exemple suivant substitue la méthode DataBind dans un contrôle serveur ASP.NET personnalisé. Il commence par appeler la méthode OnDataBinding de base avant d'utiliser la méthode ControlCollection.Clear pour supprimer tous les contrôles enfants et la méthode ClearChildViewState pour supprimer tous les paramètres d'état d'affichage enregistrés pour ces contrôles enfants. Enfin, la propriété ChildControlsCreated est affectée de la valeur true et le contrôle a pour instruction d'effectuer le suivi des modifications apportées à l'état d'affichage des contrôles récemment créés avec la méthode TrackViewState. Il s'agit d'une technique couramment utilisée lorsque des données sont liées à un contrôle, pour éviter un éventuel conflit entre les nouvelles données et celles stockées par un précédent appel à la méthode 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();
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft