HtmlForm.OnInit メソッド

.NET Framework クラス ライブラリ リファレンス

HtmlForm.OnInit メソッド

HtmlForm コントロールの Init イベントを発生させます。

名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overrides
 Sub OnInit ( _
    e As EventArgs _
)

Visual Basic (使用法)

Dim e As EventArgs

Me.OnInit(e)

C#

protected internal override void OnInit (
    EventArgs e
)

C++

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

J#

protected void OnInit (
    EventArgs e
)

JScript

protected internal override function
 OnInit (
    e : EventArgs
)

パラメータ

e

イベント データを格納している EventArgs。

解説

OnInit メソッドによって通知されると、Web サーバー コントロールはインスタンスを作成して設定するために必要な初期化の手順を実行する必要があります。サーバー コントロールの有効期間のこの段階では、コントロールのビューステートを設定する必要があります。また、このメソッドを呼び出す場合は、このコントロールの子か親かにかかわらず、他のサーバー コントロールにアクセスすることはできません。他のサーバー コントロールは、作成されていなかったり、アクセスの準備ができていなかったりする場合があります。

イベントが発生すると、デリゲートを使用してイベント ハンドラが呼び出されます。詳細については、「イベントの発生」を参照してください。

OnInit メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

OnInit メソッドは、主に、コントロール開発者が HtmlForm コントロールの機能を拡張する際に使用します。

継承時の注意 派生クラスで OnInit メソッドをオーバーライドする場合は、登録されているデリゲートがイベントを受け取るように、基本クラスの OnInit メソッドを必ず呼び出してください。また、基本クラスの OnInit メソッドを呼び出すと、HtmlForm コントロールが Web ページ フォームとして正しく設定され、ページのビューステートが保持されるようになります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HtmlForm クラス
HtmlForm メンバ
System.Web.UI.HtmlControls 名前空間
RegisterViewStateHandler
その他の技術情報
HTML サーバー コントロール