BaseDataBoundControl.RequiresDataBinding Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ruft einen Wert ab, der angibt, ob die DataBind()-Methode aufgerufen werden soll, oder legt diesen fest.

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

Boolean

Der zurückgegebene Wert ist true , wenn die -Methode des datengebundenen Steuerelements DataBind() aufgerufen werden soll, bevor das Steuerelement gerendert wird; andernfalls ist falseder Wert .

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die RequiresDataBinding -Eigenschaft von einer abgeleiteten datengebundenen Steuerelementklasse verwendet wird. Nachdem daten von der GetData -Methode abgerufen und mit PerformDataBinding der -Methode an das Steuerelement gebunden wurden, wird die RequiresDataBinding -Eigenschaft auf false festgelegt, und die MarkAsDataBound -Methode wird aufgerufen, um zu signalisieren, dass das Steuerelement die Bindung abgeschlossen hat und diese Eigenschaft während des Lebenszyklus der aktuellen Seite nicht mehr benötigt. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataBoundControl-Klasse bereitgestellt wird.

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 datengebundene Steuerelement bereits mit dem Rendern seiner Ausgabe auf der Seite begonnen hat, ist die aktuelle HTTP-Anforderung kein Rückruf, und Sie verwenden die -Eigenschaft, um das DataSourceID Datenquellensteuerelement zu identifizieren, an das gebunden werden soll, wird die DataBind -Methode sofort aufgerufen. In diesem Fall ist die RequiresDataBinding -Eigenschaft nicht tatsächlich auf truefestgelegt.

Weitere Informationen

• DataBind()
• DataSourceID