DetailsView.OnPagePreLoad(Object, EventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sets the initialized state of the data-bound control before the control is loaded.
protected:
override void OnPagePreLoad(System::Object ^ sender, EventArgs ^ e);protected override void OnPagePreLoad (object sender, EventArgs e);override this.OnPagePreLoad : obj * EventArgs -> unitProtected Overrides Sub OnPagePreLoad (sender As Object, e As EventArgs)Parameters
Remarks
The OnPagePreLoad 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 PreLoad phase of the page's life cycle, the 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 OnPagePreLoad method is overridden by the DetailsView class to set the 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 Wizard and MultiView, where the visibility of the control is changed at run time.
