Sys.Application クラス

更新 : 2007 年 11 月

クライアント イベントを公開し、アプリケーションに登録されたクライアント コンポーネントを管理するランタイム オブジェクトを提供します。このオブジェクトのメンバは、クライアント アプリケーションを初期化した後グローバルに使用できます。メンバは、クラスのインスタンスを作成しなくても呼び出すことができます。

名前空間 : Sys

継承 : Sys.Component、Sys.IContainer

Sys.Application.addComponent(componentVar);

コンストラクタ

名前	説明
Sys.Application コンストラクタ	Sys.Application クラスの新しいインスタンスを初期化します。

メンバ

名前	説明
Sys.Application.init イベント	スクリプトが読み込まれた後、オブジェクトが作成される前に発生します。
Sys.Application.load イベント	すべてのスクリプトが読み込まれ、アプリケーション内のすべてのオブジェクトが作成および初期化された後に発生します。
Sys.Application.navigate イベント	ユーザーがブラウザの [戻る] ボタンまたは [進む] ボタンをクリックしたときに発生します。
Sys.Application.unload イベント	クライアント アプリケーションのすべてのオブジェクトが破棄される前に発生します。
Sys.Application.addComponent メソッド	コンポーネントをアプリケーションに登録し、そのコンポーネントがまだ初期化されていない場合は初期化します。
Sys.Application.addHistoryPoint メソッド	履歴ポイントを作成してブラウザの履歴スタックに追加します。
Sys.Application.beginCreateComponents メソッド	アプリケーションに対して、コンポーネントの作成を開始するように指示します。
Sys.Application.beginUpdate メソッド	Sys.Application.beginUpdate メソッドによって呼び出され、アプリケーションのコンポーネントのプロパティを設定するプロセスが開始されたことを示します。
Sys.Application.dispose メソッド	クライアント アプリケーションが保持するリソースと依存関係を解放します。
Sys.Application.endCreateComponents メソッド	アプリケーションに対して、コンポーネントの作成を終了するように指示します。
Sys.Application.endUpdate メソッド	Sys.Application.endCreateComponents メソッドによって呼び出され、アプリケーションを更新するプロセスが完了したことを示します。
Sys.Application.findComponent メソッド	指定した Sys.Component オブジェクトを返します。
Sys.Application の $find メソッド	findComponent メソッドへのショートカットを提供します。
Sys.Application.getComponents メソッド	addComponent メソッドを使用してアプリケーションに登録されたすべてのコンポーネントの配列を返します。
Sys.Application.initialize メソッド	アプリケーションを初期化し、load イベントを発生させます。
Sys.Application.notifyScriptLoaded メソッド	スクリプトが読み込まれたことを示す、参照されるスクリプトにより呼び出されます。
Sys.Application.queueScriptReference メソッド	キューに配置された順番で読み込むスクリプトを順番にキューに配置します。
Sys.Application.raiseLoad メソッド	load イベントを発生させます。
Sys.Application.raisePropertyChanged メソッド	Sys.INotifyPropertyChange.propertyChanged イベントを発生させます。
Sys.Application.registerDisposableObject メソッド	破棄が必要になるオブジェクトをアプリケーションに登録します。
Sys.Application.removeComponent メソッド	オブジェクトをアプリケーションから削除し、破棄可能な場合はそのオブジェクトを破棄します。
Sys.Application.unregisterDisposableObject メソッド	破棄可能なオブジェクトをアプリケーションから登録解除します。
Sys.Application.updated メソッド	追加ロジックのプレースホルダとして Sys.Application.endUpdate メソッドによって呼び出されます。
Sys.Application.enableHistory プロパティ	Web アプリケーションが履歴ポイントの管理をサポートしているかどうかを示す値を取得または設定します。
Sys.Application.isCreatingComponents プロパティ	アプリケーションがコンポーネントを作成中かどうかを示す値を取得します。

解説

Application オブジェクトは、クライアント コンポーネント開発をサポートする関数およびイベントを提供します。Application オブジェクトは、プライベート Sys._Application クラスの単一のインスタンスです。Application オブジェクトは、ブラウザに ASP.NET AJAX ページが表示されたときに作成され、ページが有効な間は存続します。Application オブジェクトは、pageInit、pageLoad、および pageUnload などのクライアント ページ ライフ サイクル イベントを発生させ、登録されたコンポーネントの破棄を管理します。

イベント

Application オブジェクトは、init、load、および unload の各イベントを提供し、基本 Component クラスから disposing イベントと propertyChanged イベントを継承します。これらのイベントはすべて、ブラウザでのクライアント アプリケーションのライフ サイクルに適用されます。

部分ページ レンダリングがサポートされていて、ページに UpdatePanel コントロールが含まれている場合、PageRequestManager クラスは非同期にレンダリングされるページの一部に適用される追加イベントを提供します。部分ページ レンダリングの詳細については、「部分ページ レンダリングの概要」を参照してください。

個々のコンポーネントは、そのコンポーネントにのみ適用されるイベントを公開できます。さらに、Application オブジェクトを使用してアプリケーション レベルのイベントにもアクセスできます。

ほとんどの場合、ページ開発時にコードを load イベントに配置する必要があります。ページのライフ サイクルにおいて、イベントが配置された時点ですべてのスクリプトが読み込まれ、すべてのコンポーネントが作成されて使用可能になります。ページが読み込まれると、pageLoad という関数に含まれるすべてのコードが自動的に実行されます。

コンポーネントの開発時に、イベントの add_ アクセサ メソッドを呼び出し、ハンドラ関数を渡すことによって、他のイベントにアクセスしたり、追加のハンドラを load イベントまたは unload イベントにバインドできます。myUnloadHandler という関数を unload イベントにバインドする方法を次の例に示します。

Sys.Application.add_unload(myUnloadHandler)

イベントとそのハンドラが必要なくなった場合、次の例に示すように remove_ アクセサ メソッドを呼び出すことができます。

Sys.Application.remove_unload(myUnloadHandler);

add_ アクセサをハンドラごとに 1 回ずつ呼び出すことによって、追加のハンドラをイベントにアタッチできます。ハンドラは、remove_ アクセサ メソッドを呼び出して個々に削除できます。

Sys.Application のイベントの詳細については、「AJAX クライアント ライフ サイクル イベント」を参照してください。

コンポーネントの追加

ほとんどのシナリオでは、$create コマンドを使用してアプリケーションにコンポーネントを追加する必要があります。コンポーネントをアプリケーションに登録すると、findComponent メソッドまたは $find ショートカットを呼び出すことによって、アプリケーションでコンポーネントにアクセスできます。getComponents メソッドを呼び出すと、使用可能なすべてのコンポーネントのリストを取得できます。

コンポーネント、コントロール、および動作を開発する方法の詳細については、「ASP.NET コントロールへの AJAX 機能の追加」を参照してください。

スクリプト ファイルの参照

部分ページ レンダリングで使用するためにスタンドアロン スクリプト ファイル (.js file) を参照する場合、スクリプト ファイル内のコードで notifyScriptLoaded メソッドを呼び出す必要があります。これにより、スクリプトが読み込みを完了したことがアプリケーションに通知されます。詳細については、「Sys.Application.notifyScriptLoaded メソッド」を参照してください。

参照

参照

new 演算子

その他の技術情報

言語リファレンス