Metodo DataBind (Common)

Consente di creare un'associazione tra una proprietà del controllo server e un'origine dati.

public virtual void DataBind()

Ereditarietà

Tutti i controlli ereditano questo metodo direttamente dalla classe System.Web.UI.Control. Di seguito viene illustrato un elenco delle classi che ereditano la proprietà DataBind dalla classe System.Web.UI.Control.

Classe AdRotator	Classe MobileListItem
ClasseBaseValidator	Classe MobilePage
Classe Calendar	Classe ObjectList
Classe PhoneCall	Classe ObjectListItem
Classe Command	ClassePagedControl
Classe CompareValidator	Classe Panel
Classe CustomValidator	Classe RangeValidator
Classe DeviceSpecific	ClasseRegularExpressionValidator
ClasseErrorFormatterPage	ClasseRequiredFieldValidator
Classe Form	ClasseSelectionList
Classe Image	Classe StyleSheet
Classe Label	Classe TextBox
Classe Link	Classe TextControl
Classe List	Classe TextView
Classe LiteralText	Classe ValidationSummary
MobileControl

Osservazioni

Se è stata specificata un'origine dati, il controllo esegue i seguenti passaggi:

• cancella gli elementi attualmente nell'origine dati
• esegue l'associazione dati

Se deve essere compilato utilizzando un'origine dati, il controllo rimane vuoto fino a quando si verifica l'associazione dati.

Affinché il controllo esegua l'associazione dati, è necessario chiamare il metodo DataBind. La maggior parte dei controlli mobili ASP.NET supporta l'associazione dati, ma non ne richiede l'utilizzo. Tuttavia, senza l'associazione dati, il controllo ObjectList non visualizza alcun contenuto. Per ulteriori informazioni sull'associazione dati, consultare la sezione Data Access and Customization nella documentazione della Guida rapida di ASP.NET.

Esempio

Nell'esempio seguente viene descritto l'utilizzo del metodo DataBind per associare la matrice al controllo 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();
}

Vedere anche

Si applica a: metodo System.Web.UI.Control.DataBind