Control.DataBind Metodo

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.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 .

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 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

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Sviluppo di controlli server di ASP.NET personalizzati
• Panoramica del ciclo di vita della pagina ASP.NET

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

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.

Vedi anche

• DataBinding
• DataBindChildren()
• Panoramica del ciclo di vita della pagina ASP.NET