DataPager.OnLoad(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.
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
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.