Leggi in inglese

Condividi tramite

Control.DataBind Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

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

Overload

DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.
DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.

DataBind()

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

C# 
public virtual void DataBind();

Esempio

Nell'esempio seguente viene eseguito l'override del DataBind metodo in un controllo server di ASP.NET personalizzato. Inizia chiamando il metodo base OnDataBinding e quindi usa il metodo per eliminare tutti i controlli figlio e il ControlCollection.ClearClearChildViewState metodo per eliminare le impostazioni dello stato di visualizzazione salvate per tali controlli figlio. Infine, la ChildControlsCreated proprietà è impostata su true e il controllo viene incaricato di tenere traccia delle modifiche apportate allo stato di visualizzazione dei controlli appena creati con il TrackViewState metodo . Si tratta di una tecnica comune quando si associano dati a un controllo per garantire che i nuovi dati non siano in conflitto con i dati archiviati da una chiamata di metodo precedente DataBind .

C# 
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();
}

Commenti

Usare questo metodo per associare i dati da un'origine a un controllo server. Questo metodo viene comunemente usato dopo il recupero di un set di dati tramite una query di database. La maggior parte dei controlli esegue automaticamente il data binding, che significa che in genere non è necessario chiamare in modo esplicito questo metodo.

Questo metodo viene comunemente sottoposto a override quando si crea un controllo associato a dati modelli personalizzato. Per altre informazioni, vedere Procedura: Creare controlli utente modelli ASP.NET e sviluppare controlli server Web personalizzati Data-Bound. Quando viene chiamato in un controllo server, questo metodo risolve tutte le espressioni di associazione dati nel controllo server e in uno dei controlli figlio.

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.

C# 
protected virtual void DataBind(bool raiseOnDataBinding);

Parametri

raiseOnDataBinding
Boolean

true se viene generato l'evento DataBinding; in caso contrario, false.

Commenti

Usare il metodo in uno scenario quando il Control.DataBind(Boolean) controllo personalizzato esegue l'override del DataBind metodo e implementa l'interfaccia IDataItemContainer . In questo scenario il controllo personalizzato chiama il metodo con raiseOnDataBinding impostato per false assicurarsi che venga chiamato il Control.DataBind(Boolean) metodo della DataBind classe base.

Il Control.DataBind() metodo richiama il Control.DataBind(Boolean) metodo con raiseOnDataBinding impostato su true.

Nota

La chiamata al metodo con raiseOnDataBinding set per causare l'associazione Control.DataBind(Boolean) di dati a false qualsiasi controllo figlio con il Control.DataBind() metodo .

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1