BaseDataBoundControl.OnPagePreLoad(Object, EventArgs) Method

Definition

Sets the initialized state of the data-bound control before the control is loaded.

protected:
 virtual void OnPagePreLoad(System::Object ^ sender, EventArgs ^ e);
protected virtual void OnPagePreLoad (object sender, EventArgs e);
abstract member OnPagePreLoad : obj * EventArgs -> unit
override this.OnPagePreLoad : obj * EventArgs -> unit
Protected Overridable Sub OnPagePreLoad (sender As Object, e As EventArgs)

Parameters

sender
Object

The Page that raised the event.

e
EventArgs

An EventArgs object that contains the event data.

Remarks

The OnPagePreLoad event handler 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 lifecycle, 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.

Applies to

See also