BaseDataBoundControl.RequiresDataBinding Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ottiene o imposta un valore che indica se deve essere chiamato il metodo 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

Valore della proprietà

Boolean

Il valore restituito è true se il metodo del controllo DataBind() associato ai dati deve essere chiamato prima del rendering del controllo. In caso contrario, il valore è false.

Esempio

Nell'esempio di codice seguente viene illustrato come la RequiresDataBinding proprietà viene usata da una classe di controllo associata a dati derivata. Dopo aver recuperato i dati dal GetData metodo e associato al controllo con PerformDataBinding il metodo, la RequiresDataBinding proprietà è impostata su false e il MarkAsDataBound metodo viene chiamato per segnalare che il controllo ha completato l'associazione e non richiede più questa proprietà durante il ciclo di vita della pagina corrente. Questo esempio di codice fa parte di un esempio più grande fornito per la 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

Commenti

Se si imposta la RequiresDataBinding proprietà su true quando il controllo associato ai dati ha già iniziato a eseguire il rendering dell'output nella pagina, la richiesta HTTP corrente non è un callback e si usa la DataSourceID proprietà per identificare il controllo origine dati da associare a, il DataBind metodo viene chiamato immediatamente. In questo caso, la RequiresDataBinding proprietà non è effettivamente impostata su true.

Vedi anche

• DataBind()
• DataSourceID