System.Web.UI.WebControls.DetailsView.OnPagePreLoad Method

Sets the initialized state of the data-bound control before the control is loaded.

Syntax

protected override void OnPagePreLoad (object sender, EventArgs e)

Parameters

sender
The System.Web.UI.Page that raised the event.
e
An EventArgs that contains the event data.

Remarks

The DetailsView.OnPagePreLoad(object, EventArgs) method is used to control when data binding occurs within the life cycle of the page. It does this by setting the internal initialized state of the data-bound control. Because the control's initialized state is set during the System.Web.UI.Page.PreLoad phase of the page's life cycle, the DataBoundControl.OnDataPropertyChanged event handler is called any time a data property of the control is changed after that phase, to signal that the control must re-bind to its data before rendering.

The DetailsView.OnPagePreLoad(object, EventArgs) method is overridden by the System.Web.UI.WebControls.DetailsView class to set the BaseDataBoundControl.RequiresDataBinding property to true in cases where the HTTP request is a postback and view state is enabled but the data-bound control has not yet been bound. This scenario is common with controls such as System.Web.UI.WebControls.Wizard and System.Web.UI.WebControls.MultiView, where the visibility of the control is changed at run time.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0