OnInit Method

ControlAdapter::OnInit Method (EventArgs^)


Overrides the OnInit method for the associated control.

Namespace:   System.Web.UI.Adapters
Assembly:  System.Web (in System.Web.dll)

public protected:
virtual void OnInit(
	EventArgs^ e


Type: System::EventArgs^

An EventArgs that contains the event data.

If there is an adapter attached to a Control object and the OnInit method is overridden, the override method is called instead of the Control::OnInit method.

Override OnInit to perform target-specific processing in the Initialize stage of the control lifecycle. Typically, these are functions that are performed when a control is created.

Notes to Inheritors:

When you inherit from the ControlAdapter class and the adapter overrides the OnInit method, the adapter must call the corresponding base class method, which in turn calls the Control::OnInit method. If the Control::OnInit method is not called, the Control::Init event will not be raised.

The following code sample derives a custom control adapter from the ControlAdapter class. It then overrides the OnInit method to set a property on the associated control and call the base method to complete the control initialization.

#using <System.Web.dll>
#using <System.dll>

using namespace System;
using namespace System::Web::UI;
using namespace System::Web::UI::Adapters;

public ref class CustomControlAdapter: public ControlAdapter
   // Override the ControlAdapter default OnInit implementation.
   virtual void OnInit( EventArgs^ e ) override
      // Make the control invisible.
      Control->Visible = false;

      // Call the base method, which calls OnInit of the control,
      // which raises the control Init event.
      ControlAdapter::OnInit( e );

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft