Control.DataBind Metodo

Definizione

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.

public:
 virtual void DataBind();
public virtual void DataBind ();
abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit
Public Overridable Sub 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.Clear ClearChildViewState 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 .

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

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 ASP.NET modelli 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

DataBind(Boolean)

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

protected:
 virtual void DataBind(bool raiseOnDataBinding);
protected virtual void DataBind (bool raiseOnDataBinding);
abstract member DataBind : bool -> unit
override this.DataBind : bool -> unit
Protected Overridable Sub DataBind (raiseOnDataBinding As Boolean)

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