DataBoundControl.MarkAsDataBound Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Sets the state of the control in view state as successfully bound to data.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

Protected Sub MarkAsDataBound

The data-bound control maintains a value in view state that indicates whether it is currently bound to data. The MarkAsDataBound method sets the value to true.

The following code example demonstrates how the MarkAsDataBound method is used by a derived data-bound control class. 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 it during the current page's life cycle. This code example is part of a larger example provided for the DataBoundControl class.

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

    ' Raise the DataBound event.

End Sub 'PerformSelect

.NET Framework
Available since 2.0
Return to top