BaseDataBoundControl.RequiresDataBinding Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si se debe llamar al método DataBind().
protected:
property bool RequiresDataBinding { bool get(); void set(bool value); };
protected bool RequiresDataBinding { get; set; }
member this.RequiresDataBinding : bool with get, set
Protected Property RequiresDataBinding As Boolean
Valor de propiedad
El valor devuelto es true
si se debe llamar al método del DataBind() control enlazado a datos antes de que se represente el control; de lo contrario, el valor es false
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usa la RequiresDataBinding propiedad una clase de control enlazada a datos derivada. Una vez recuperados los datos por el GetData método y enlazados al control con el PerformDataBinding método , la RequiresDataBinding propiedad se establece false
en y se llama al MarkAsDataBound método para indicar que el control ha completado el enlace y ya no requiere esta propiedad durante el ciclo de vida de la página actual. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase DataBoundControl.
protected override void PerformSelect() {
// Call OnDataBinding here if bound to a data source using the
// DataSource property (instead of a DataSourceID), because the
// databinding statement is evaluated before the call to GetData.
if (! IsBoundUsingDataSourceID) {
OnDataBinding(EventArgs.Empty);
}
// The GetData method retrieves the DataSourceView object from
// the IDataSource associated with the data-bound control.
GetData().Select(CreateDataSourceSelectArguments(),
OnDataSourceViewSelectCallback);
// The PerformDataBinding method has completed.
RequiresDataBinding = false;
MarkAsDataBound();
// Raise the DataBound event.
OnDataBound(EventArgs.Empty);
}
Protected Overrides Sub PerformSelect()
' Call OnDataBinding here if bound to a data source using the
' DataSource property (instead of a DataSourceID) because the
' data-binding statement is evaluated before the call to GetData.
If Not IsBoundUsingDataSourceID Then
OnDataBinding(EventArgs.Empty)
End If
' The GetData method retrieves the DataSourceView object from the
' IDataSource associated with the data-bound control.
GetData().Select(CreateDataSourceSelectArguments(), _
AddressOf OnDataSourceViewSelectCallback)
' The PerformDataBinding method has completed.
RequiresDataBinding = False
MarkAsDataBound()
' Raise the DataBound event.
OnDataBound(EventArgs.Empty)
End Sub
Comentarios
Si establece la RequiresDataBinding propiedad true
en cuando el control enlazado a datos ya ha comenzado a representar su salida en la página, la solicitud HTTP actual no es una devolución de llamada y usa la DataSourceID propiedad para identificar el control de origen de datos al que se va a enlazar, DataBind se llama al método inmediatamente. En este caso, la RequiresDataBinding propiedad no se establece realmente en true
.