Export (0) Print
Expand All
Expand Minimize

DetailsView.OnPagePreLoad Method

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

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

'Declaration
Protected Overrides Sub OnPagePreLoad ( _
	sender As Object, _
	e As EventArgs _
)

Parameters

sender
Type: System.Object

The Page that raised the event.

e
Type: System.EventArgs

An EventArgs that contains the event data.

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.

.NET Framework

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

Windows 8.1, Windows Server 2012 R2, 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.

Show:
© 2014 Microsoft