Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Control.DataBind

Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio.

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public virtual void DataBind()

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 How to: Create Templated User Controls e Developing Custom Data-Bound Web Server Controls. 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 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

Supportato in: 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 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft