DataBind, méthode (Common)

Crée une liaison entre une propriété de contrôle serveur et une source de données.

public virtual void DataBind()

Héritage

Tous les contrôles héritent directement cette méthode de la classe System.Web.UI.Control. La liste suivante répertorie les classes qui héritent de la propriété DataBind de la classe System.Web.UI.Control.

AdRotator, classe	MobileListItem, classe
BaseValidator, classe	MobilePage, classe
Calendar, classe	ObjectList, classe
PhoneCall, classe	ObjectListItem, classe
Command, classe	PagedControl, classe
CompareValidator, classe	Panel, classe
CustomValidator, classe	RangeValidator, classe
DeviceSpecific, classe	RegularExpressionValidator, classe
ErrorFormatterPage, classe	RequiredFieldValidator, classe
Form, classe	SelectionList, classe
Image, classe	StyleSheet, classe
Label, classe	TextBox, classe
Link, classe	TextControl, classe
List, classe	TextView, classe
LiteralText, classe	ValidationSummary, classe
MobileControl, classe

Notes

Si une source de données est spécifiée, le contrôle exécute les étapes suivantes :

• effacement des éléments présents dans la source de données ;
• liaison des données.

Si un contrôle doit être rempli via une source de données, il reste vide jusqu'à ce que la liaison de données se produise.

Pour permettre au contrôle de lier les données, vous devez appeler la méthode DataBind. La plupart des contrôles mobiles ASP.NET prennent en charge la liaison de données, mais ils ne l'exigent pas. Cependant, sans liaison de données, le contrôle ObjectList ne peut jamais afficher de contenu. Pour plus d'informations sur la liaison de données, consultez la section Accès aux données et personnalisation dans la rubrique Démarrages rapides de la documentation ASP.NET.

Exemple

L'exemple suivant montre comment utiliser la méthode DataBind pour lier le tableau à ObjectList.

Class Task
   Private _TaskName As String
   Private _Editable As String
   Private _Priority As Integer
   
   Public Sub New(TaskName As String, Editable As String, Priority As Integer)
      _TaskName = TaskName
      _Editable = Editable
      _Priority = Priority
   End Sub 'New
   
   Public ReadOnly Property TaskName() As String
      Get
         Return _TaskName
      End Get
   End Property
   
   Public ReadOnly Property Editable() As String
      Get
         Return _Editable
      End Get
   End Property
   
   Public ReadOnly Property Priority() As Integer
      Get
         Return _Priority
      End Get
   End Property
End Class 

Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

   ArrayList arr = new ArrayList();
   // Start initial creation and filling of array.
   arr.Add (new Task ("Tomorrow's work", "yes", 2));
   arr.Add (new Task ("Today's work", "yes", 1));
   arr.Add (new Task ("Yesterday's work", "No", 3));   
   ObjectList1.DataSource = arr;
   ObjectList1.DataBind();

End Sub

[C#]

class Task
{
   private string _TaskName;
   private string _Editable;
   private int   _Priority;
   public Task(string TaskName, string Editable, int Priority) 
   { 
      _TaskName = TaskName; 
      _Editable = Editable;
      _Priority = Priority;
   }   
   public string TaskName { get { return _TaskName; } }
   public string Editable { get { return _Editable; } }
   public int Priority { get { return _Priority; } }
}
public void Page_Load(Object sender, EventArgs e)
{
   ArrayList arr = new ArrayList();
   // Start initial creation and filling of array.
   arr.Add (new Task ("Tomorrow's work", "yes", 2));
   arr.Add (new Task ("Today's work", "yes", 1));
   arr.Add (new Task ("Yesterday's work", "No", 3));   
   ObjectList1.DataSource = arr;
   ObjectList1.DataBind();
}

Voir aussi

S'applique à : DataBind, méthode