BaseDataBoundControl.RequiresDataBinding Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy DataBind() Metoda powinna być wywoływana.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

Wartość właściwości

Boolean

Zwracana wartość to true , czy metoda kontrolki powiązanej z danymi DataBind() powinna zostać wywołana przed renderowaniem kontrolki; w przeciwnym razie wartość to false .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.

Przykłady

Poniższy przykład kodu demonstruje, jak RequiresDataBinding Właściwość jest używana przez pochodną klasę formantu powiązanego z danymi.The following code example demonstrates how the RequiresDataBinding property is used by a derived data-bound control class. Gdy dane są pobierane przez GetData metodę i powiązane z kontrolką przy użyciu PerformDataBinding metody, RequiresDataBinding Właściwość jest ustawiona na, false a MarkAsDataBound Metoda jest wywoływana do sygnalizowania, że formant ukończył powiązanie i nie wymaga już tej właściwości podczas cyklu życia bieżącej strony.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. Ten przykład kodu jest częścią większego przykładu dostarczonego dla DataBoundControl klasy.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

Uwagi

Jeśli właściwość zostanie ustawiona RequiresDataBinding na true , gdy kontrolka powiązane z danymi już zaczęła przetworzyć dane wyjściowe na stronie, bieżące żądanie HTTP nie jest wywołaniem zwrotnym i jest używana DataSourceID Właściwość do identyfikacji kontroli źródła danych, z którą ma zostać utworzone powiązanie DataBind . Metoda ta jest wywoływana natychmiast.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. W tym przypadku RequiresDataBinding Właściwość nie jest ustawiana na true .In this case, the RequiresDataBinding property is not actually set to true.

Dotyczy

Zobacz też