BaseDataBoundControl.RequiresDataBinding Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtém ou define um valor que indica se o método DataBind() deve ser cancelado.

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

Boolean

O valor retornado é true se o método DataBind() do associado a dados deve ser chamado antes que o controle seja renderizado; caso contrário, o valor é false.

Exemplos

O exemplo de código a seguir demonstra como a RequiresDataBinding propriedade é usada por uma classe de controle associada a dados derivada. Depois que os GetData dados são recuperados pelo método e associados ao controle com o PerformDataBinding método, a RequiresDataBinding propriedade é definida false e o MarkAsDataBound método é chamado para sinalizar que o controle concluiu a associação e não requer mais essa propriedade durante o ciclo de vida da página atual. Este exemplo de código faz parte de um exemplo maior fornecido para a DataBoundControl classe.

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

Comentários

Se você definir a RequiresDataBinding propriedade para true quando o controle associado a dados já tiver começado a renderizar sua saída para a página, a solicitação HTTP atual não será um retorno de chamada e você estiver usando a DataSourceID propriedade para identificar o controle da fonte de dados a ser associado, o DataBind método será chamado imediatamente. Nesse caso, a RequiresDataBinding propriedade não está definida como true.

Confira também

• DataBind()
• DataSourceID