BaseDataBoundControl.RequiresDataBinding BaseDataBoundControl.RequiresDataBinding BaseDataBoundControl.RequiresDataBinding BaseDataBoundControl.RequiresDataBinding Property

Definizione

Ottiene o imposta un valore che indica se deve essere chiamato il metodo DataBind().Gets or sets a value indicating whether the DataBind() method should be called.

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à

Il valore restituito è true se il DataBind() metodo del controllo con associazione a dati deve essere chiamato prima del rendering del controllo; in caso contrario, falseil valore è.The returned value is true if the data-bound control's DataBind() method should be called before the control is rendered; otherwise, the value is false.

Esempi

Nell'esempio di codice seguente viene illustrata la modalità di utilizzo della proprietà da parte RequiresDataBinding di una classe di controlli con associazione a dati derivata.The following code example demonstrates how the RequiresDataBinding property is used by a derived data-bound control class. Dopo che GetData i dati sono stati recuperati dal metodo e associati al controllo PerformDataBinding con il metodo RequiresDataBinding , la proprietà viene false impostata su MarkAsDataBound e viene chiamato il metodo per segnalare che il controllo ha completato l'associazione e non è più richiede questa proprietà durante il ciclo di vita della pagina corrente.After data is retrieved by the GetData method and bound to the control with the PerformDataBinding method, the RequiresDataBinding property is set to false and the MarkAsDataBound method is called to signal that the control has completed binding and no longer requires this property during the current page's lifecycle. Questo esempio di codice fa parte di un esempio più ampio fornito DataBoundControl per la classe.This code example is part of a larger example provided for the DataBoundControl class.

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 'PerformSelect

Commenti

Se si imposta la RequiresDataBinding proprietà su true quando il controllo con associazione a dati ha già iniziato a eseguire il rendering dell'output nella pagina, la richiesta HTTP corrente non è un callback e si utilizza la DataSourceID proprietà per identificare il controllo origine dati associare a, il DataBind metodo viene chiamato immediatamente.If you set the RequiresDataBinding property to true when the data-bound control has already begun to render its output to the page, the current HTTP request is not a callback, and you are using the DataSourceID property to identify the data source control to bind to, the DataBind method is called immediately. In questo caso, la RequiresDataBinding proprietà non viene effettivamente impostata su true.In this case, the RequiresDataBinding property is not actually set to true.

Si applica a

Vedi anche