Edit

Share via


DataPager.OnLoad(EventArgs) Method

Definition

Raises the Load event.

protected public:
 override void OnLoad(EventArgs ^ e);
protected internal override void OnLoad (EventArgs e);
override this.OnLoad : EventArgs -> unit
Protected Friend Overrides Sub OnLoad (e As EventArgs)

Parameters

e
EventArgs

The event data.

Exceptions

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

Remarks

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 Handling and Raising Events.

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(EventArgs) in a derived class, make sure that you call the base class' OnLoad(EventArgs) method so that registered delegates receive the event.

Applies to

See also