Control.DataBind Método

Definición

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

Sobrecargas

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

public:
 virtual void DataBind();
public virtual void DataBind ();
abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit
Public Overridable Sub DataBind ()

Ejemplos

En el ejemplo siguiente se invalida el DataBind método en un control de servidor de ASP.NET personalizado. Comienza llamando al método base OnDataBinding y, a continuación, usa el ControlCollection.Clear método para eliminar todos los controles secundarios y el ClearChildViewState método para eliminar cualquier configuración de estado de vista guardada para esos controles secundarios. Por último, la ChildControlsCreated propiedad se establece true en y se indica al control que realice un seguimiento de los cambios en el estado de vista de los controles recién creados con el TrackViewState método . Se trata de una técnica común al enlazar datos a un control para asegurarse de que los nuevos datos no entran en conflicto con los datos almacenados desde una llamada de método anterior 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

Comentarios

Use este método para enlazar datos de un origen a un control de servidor. Este método se usa normalmente después de recuperar un conjunto de datos a través de una consulta de base de datos. La mayoría de los controles realizan el enlace de datos automáticamente, lo que significa que normalmente no es necesario llamar a este método explícitamente.

Este método se reemplaza normalmente cuando se crea un control enlazado a datos con plantilla personalizado. Para obtener más información, vea How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls. Cuando se llama a en un control de servidor, este método resuelve todas las expresiones de enlace de datos en el control de servidor y en cualquiera de sus controles secundarios.

Consulte también

Se aplica a

DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el 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)

Parámetros

raiseOnDataBinding
Boolean

true si se genera el evento DataBinding; en caso contrario, false.

Comentarios

Use el Control.DataBind(Boolean) método en un escenario cuando el control personalizado invalide el DataBind método e implemente la IDataItemContainer interfaz . En este escenario, el control personalizado llama al Control.DataBind(Boolean) método con raiseOnDataBinding establecido para false asegurarse de que se llama al método de DataBind la clase base.

El Control.DataBind() método invoca el Control.DataBind(Boolean) método con raiseOnDataBinding establecido en true.

Nota

Llamar al Control.DataBind(Boolean) método con raiseOnDataBinding establecido en false hace que los controles secundarios estén enlazados a datos con el Control.DataBind() método .

Consulte también

Se aplica a