BaseDataBoundControl.RequiresDataBinding Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setProtected Property RequiresDataBinding As BooleanEigenschaftswert
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.
