BaseDataBoundControl.RequiresDataBinding Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die DataBind()-Methode aufgerufen werden soll, oder legt diesen fest.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

Eigenschaftswert

Der zurückgegebene Wert true ist, wenn die-Methode des DataBind() Daten gebundenen Steuer Elements aufgerufen werden soll, bevor das-Steuerelement gerendert wird. andernfalls ist falseder Wert.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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, RequiresDataBinding wie die-Eigenschaft von einer abgeleiteten Daten gebundenen Steuerelement Klasse verwendet wird.The following code example demonstrates how the RequiresDataBinding property is used by a derived data-bound control class. Nachdem die Daten GetData von der-Methode abgerufen und mit der PerformDataBinding -Methode an das-Steuer RequiresDataBinding Element gebunden wurden, false wird die MarkAsDataBound -Eigenschaft auf festgelegt, und die-Methode wird aufgerufen, um zu signalisieren, dass das Steuerelement die Bindung abgeschlossen hat und erfordert diese Eigenschaft während des Lebenszyklus der aktuellen Seite.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. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataBoundControl -Klasse bereitgestellt wird.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

Hinweise

Wenn Sie die RequiresDataBinding -Eigenschaft auf true festlegen, wenn das Daten gebundene Steuerelement bereits damit begonnen hat, seine Ausgabe auf der Seite zu renderten, ist die aktuelle HTTP-Anforderung kein Rückruf DataSourceID , und Sie verwenden die-Eigenschaft, um das Datenquellen-Steuerelement zu identifizieren. Binden an. die DataBind -Methode wird sofort aufgerufen.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 diesem Fall wird die RequiresDataBinding -Eigenschaft nicht auf truefestgelegt.In this case, the RequiresDataBinding property is not actually set to true.

Gilt für:

Siehe auch