ScriptManager コントロール

ScriptManager コントロールは、AJAX 対応の ASP.NET Web ページのクライアント スクリプトを管理します。既定では、ScriptManager コントロールは Microsoft AJAX ライブラリのスクリプトをページに登録します。これにより、クライアント スクリプトは、型システム拡張機能を使用して部分ページ レンダリングや Web サービス呼び出しなどの機能をサポートできます。

ScriptManager コントロールが正常に機能するためには、web.config ファイルに特定の設定が必要です。このコントロールを使用するときに、サイトに必要な web.config ファイルが存在しないと、コントロールが表示されるはずのページの [デザイン] ビューにエラーが表示されます。[デザイン] ビューでその状態のコントロールをクリックすると、Microsoft Expression Web のオプションが表示されて、新しい web.config ファイルを作成するか、既存の web.config ファイルを更新するかの選択を求められます。

シナリオ

ASP.NET の次のような AJAX 機能を有効にするときに、ScriptManager コントロールをページで使用する必要があります。

  • Microsoft AJAX Library のクライアント スクリプト機能と、ブラウザーに送信するすべてのカスタム スクリプト。

  • ポストバックを実行せずにページ上の領域を個別に更新できる、部分ページ レンダリング。部分ページ レンダリングをサポートするには、ASP.NET の UpdatePanelUpdateProgressTimer の各コントロールに ScriptManager コントロールが必要です。

  • Web サービスの JavaScript プロキシ クラス。これを使用すると、クライアント スクリプトを使用して Web サービスや ASP.NET ページ内の特別にマークされたメソッドにアクセスできます。そのためには、Web サービスとページのメソッドを厳密に型指定されたオブジェクトとして公開します。

  • ASP.NET の認証、プロファイル、およびロール アプリケーションの各サービスにアクセスする JavaScript クラス。

背景

ScriptManager コントロールは、ページに UpdatePanel コントロールが含まれている場合に、ブラウザーでの部分ページ レンダリングを管理します。このコントロールは、ページのライフ サイクルとやり取りして、ページの UpdatePanel コントロール内部にある部分を更新します。詳細については、「部分ページ レンダリングの概要」を参照してください。

ページが部分ページ更新に参加するかどうかは、ScriptManager コントロールの EnablePartialRendering プロパティによって決まります。既定では、EnablePartialRendering プロパティは true です。したがって、既定では、ページに ScriptManager コントロールを追加すると、部分ページ レンダリングが有効になります。ScriptManagerUpdatePanel コントロールを使用する方法については、「チュートリアル : UpdatePanel コントロールを間隔として指定された時間が経過するごとに更新する方法」および「チュートリアル : 個別に更新する 2 つの領域を持つページを作成する方法」を参照してください。

ScriptManagerProxy クラス

ページに追加できる ScriptManager コントロールのインスタンスは 1 つだけです。コントロールはページに直接含めることも、入れ子になったコンポーネント (ユーザー コントロール、マスター ページのコンテンツ ページ、入れ子になったマスター ページなど) の内部に間接的に含めることもできます。ページに既に ScriptManager コントロールが含まれているが、入れ子になったコンポーネントや親コンポーネントで ScriptManager コントロールの追加機能が必要な場合は、コンポーネントに ScriptManagerProxy コントロールを含めることができます。たとえば、ScriptManagerProxy コントロールを使用して、入れ子になったコンポーネントに固有のスクリプトおよびサービスを追加します。詳細については、「ScriptManagerProxy コントロール」を参照してください。

ScriptManager コントロールの詳細については、MSDN ライブラリの「ScriptManager コントロールの概要 Cc295440.xtlink_newWindow(ja-jp,Expression.40).png」を参照してください。

すべての ScriptManager コントロール プロパティの説明については、MSDN ライブラリの「ScriptManager プロパティ Cc295440.xtlink_newWindow(ja-jp,Expression.40).png」を参照してください。

関連項目

概念

ASP.NET AJAX コントロール
UpdatePanel コントロール
UpdateProgress コントロール
Timer コントロール
部分ページ レンダリングの概要