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)

protected override void OnPagePreLoad (
	Object sender,
	EventArgs e
)
protected void OnPagePreLoad (
	Object sender, 
	EventArgs e
)
protected override function OnPagePreLoad (
	sender : Object, 
	e : EventArgs
)
Not applicable.

Parameters

sender

The Page that raised the event.

e

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.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: