BaseDataBoundControl.RequiresDataBinding Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

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

Boolean

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.

Consulte también

• DataBind()
• DataSourceID