DataPager::OnLoad Method (EventArgs^)

 

This API supports the product 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)

public protected:
virtual void OnLoad(
	EventArgs^ e
) override

Parameters

e
Type: System::EventArgs^

The event data.

Exception Condition
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 NIB: 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
Available since 3.5
Return to top
Show: