Condividi tramite

Control.DataBind Metodo

Definizione

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

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

Overload

Nome Descrizione
DataBind()

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

Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding .

DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i relativi 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 ASP.NET personalizzato. Inizia chiamando il metodo di base OnDataBinding e quindi usa il ControlCollection.Clear metodo per eliminare tutti i controlli figlio e il ClearChildViewState metodo per eliminare le impostazioni dello stato di visualizzazione salvate per tali controlli figlio. Infine, la ChildControlsCreated proprietà è impostata su true e viene richiesto al controllo di tenere traccia delle modifiche apportate allo stato di visualizzazione dei nuovi controlli creati con il TrackViewState metodo . Si tratta di una tecnica comune quando si associano dati a un controllo per assicurarsi 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

Utilizzare questo metodo per associare 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, il che significa che in genere non è necessario chiamare questo metodo in modo esplicito.

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

Vedi anche

Si applica a

DataBind(Boolean)

Associa un'origine dati al controllo server richiamato e a tutti i 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 l'evento DataBinding viene generato; in caso contrario, false.

Commenti

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

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

Annotazioni

La chiamata al Control.DataBind(Boolean) metodo con raiseOnDataBinding impostato su false fa sì che tutti i controlli figlio siano associati al Control.DataBind() metodo .

Vedi anche

Si applica a