Metodo Control.DataBind (System.Web.UI)

Utilizzare questo metodo per associare i dati da un'origine a un controllo server. Questo metodo viene di solito utilizzato dopo il recupero di un set di dati tramite una query al database. Poiché la maggior parte dei controlli esegue automaticamente l'associazione dati, in genere non è necessario chiamare in modo esplicito questo metodo.

Questo metodo viene di solito sottoposto a override quando si crea un controllo personalizzato basato su template e con associazione a dati. Per ulteriori informazioni, vedere Procedura: creare controlli utente ASP.NET basati su modelli e Sviluppo di controlli server Web personalizzati con associazione a dati per ASP.NET 2.0. Quando viene chiamato su un controllo server, il metodo risolve tutte le espressioni di associazione ai dati nel controllo server e in tutti i relativi controlli figlio.

Nell'esempio riportato di seguito il metodo DataBind in un controllo server ASP.NET personalizzato viene sottoposto a override. All'inizio viene chiamato il metodo base OnDataBinding, quindi viene utilizzato il metodo ControlCollection.Clear per eliminare tutti i controlli figlio e il metodo ClearChildViewState per eliminare eventuali impostazioni salvate relative allo stato di visualizzazione di tali controlli figlio. Infine, la proprietà ChildControlsCreated viene impostata su true e al controllo viene richiesto di di tenere traccia delle eventuali modifiche apportate allo stato di visualizzazione dei controlli appena creati con il metodo TrackViewState. Questa è una tecnica comune quando si associano dati a un controllo per assicurare che i nuovi dati non siano in conflitto con i dati memorizzati da una precedente chiamata al metodo DataBind.

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

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

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti

Altre risorse