HtmlForm.OnInit(EventArgs) Метод

Определение

Создает событие Init элемента управления HtmlForm.Raises the Init event for the HtmlForm control.

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

Параметры

e
EventArgs

Объект EventArgs, содержащий данные события.A EventArgs that contains event data.

Комментарии

При уведомлении по методу OnInit элементы управления веб-сервера должны выполнить все шаги инициализации, необходимые для создания и настройки экземпляра.When notified by the OnInit method, Web server controls must perform any initialization steps that are required to create and set up an instance. На этом этапе жизненного цикла серверного элемента управления состояние представления элемента управления еще заполнено.In this stage of the server control's life cycle, the control's view state has yet to be populated. Кроме того, при вызове этого метода доступ к другим серверным элементам управления невозможен, независимо от того, является ли он дочерним или родительским для этого элемента управления.Additionally, you cannot access other server controls when this method is called, regardless of whether it is a child or parent to this control. Не гарантируется, что другие серверные элементы управления будут созданы и готовы к доступу.Other server controls are not guaranteed to be created and ready for access.

При возникновении события через делегат вызывается обработчик события.Raising an event invokes the event handler through a delegate. Дополнительные сведения см. в разделе обработка и вызов событий.For more information, see Handling and Raising Events.

Метод OnInit также позволяет производным классам обрабатывать событие, не присоединяя делегат.The OnInit method also allows derived classes to handle the event without attaching a delegate. Это предпочтительная методика обработки событий в производном классе.This is the preferred technique for handling the event in a derived class.

Метод OnInit используется главным образом разработчиками элементов управления, расширяя функциональные возможности элемента управления HtmlForm.The OnInit method is used primarily by control developers extending the functionality of the HtmlForm control.

Примечания для тех, кто наследует этот метод

При переопределении метода OnInit(EventArgs) в производном классе обязательно вызовите метод OnInit(EventArgs) базового класса, чтобы зарегистрированные делегаты получили событие.When overriding the OnInit(EventArgs) method in a derived class, be sure to call the base class's OnInit(EventArgs) method so that registered delegates receive the event. Кроме того, вызов метода OnInit(EventArgs) базового класса обеспечивает правильную настройку элемента управления HtmlForm в качестве формы веб-страницы и сохранение состояния просмотра страницы.Additionally, calling the base class's OnInit(EventArgs) method ensures that the HtmlForm control is properly set as the Web page form and the page's view state is persisted.

Применяется к

Дополнительно