This topic has not yet been rated - Rate this topic

DataBoundControl.MarkAsDataBound Method

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)
'Declaration
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
            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 'PerformSelect

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.