This documentation is archived and is not being maintained.

DataPager.OnLoad Method

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Raises the Load event.

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

protected internal override void OnLoad(
	EventArgs e
)

Parameters

e
Type: System.EventArgs
The event data.

ExceptionCondition
InvalidOperationException

A container control that implements the IPageableItemContainer interface was not found.

The OnLoad method notifies the server control that it should perform actions that are common to each HTTP request for the page that it is associated with. At this stage in the page life cycle, server controls in the hierarchy are created and initialized. View state is restored, and form controls reflect values that were posted from the client. This implementation also invokes the FindPageableItemContainer method to find the container control that implements the IPageableItemContainer interface, and it initializes the page properties.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

The OnLoad method also enables derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors

When you override OnLoad in a derived class, make sure that you call the base class’s OnLoad method so that registered delegates receive the event.

.NET Framework

Supported in: 4, 3.5

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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