ScriptManager.RegisterClientScriptResource メソッド

  • リファレンス

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.Extensions.dll

部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを ScriptManager コントロールに登録します。

オーバーロード

RegisterClientScriptResource(Page, Type, String)

ポストバックが発生するたびに、アセンブリに埋め込まれているクライアント スクリプト ファイルを ScriptManager コントロールに登録します。
RegisterClientScriptResource(Control, Type, String)

部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを ScriptManager コントロールに登録します。

RegisterClientScriptResource(Page, Type, String)

ポストバックが発生するたびに、アセンブリに埋め込まれているクライアント スクリプト ファイルを ScriptManager コントロールに登録します。

public:
 static void RegisterClientScriptResource(System::Web::UI::Page ^ page, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource (System.Web.UI.Page page, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Page * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (page As Page, type As Type, resourceName As String)

パラメーター

page
Page

スクリプトを登録するページ オブジェクト。

type
Type

クライアント スクリプトの型。 このパラメーターは、通常、typeof 演算子 (C#) または GetType 演算子 (Visual Basic) を使用して指定され、スクリプトを登録するコントロールの型を取得します。

resourceName
String

リソースの識別子。

例外

ArgumentNullException

クライアント リソースの type が null です。

  • または - スクリプトを登録するページが null です。

注釈

このメソッドでスクリプト ファイルを登録すると、非同期ポストバックが発生するたびにスクリプトがレンダリングされます。 コントロール内にあるコントロールのスクリプトを UpdatePanel 登録し、コントロールが更新されたときにのみ UpdatePanel スクリプトが登録されるようにするには、このメソッドのオーバーロードを RegisterClientScriptResource(Control, Type, String) 使用します。

部分ページの更新に関連しないスクリプト ブロックを登録し、初期ページ レンダリング中にスクリプト ブロックを 1 回だけ登録する場合は、クラスのメソッドをRegisterClientScriptBlockClientScriptManager使用します。 ページのプロパティからオブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。

こちらもご覧ください

適用対象

RegisterClientScriptResource(Control, Type, String)

部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを ScriptManager コントロールに登録します。

public:
 static void RegisterClientScriptResource(System::Web::UI::Control ^ control, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource (System.Web.UI.Control control, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Control * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (control As Control, type As Type, resourceName As String)

パラメーター

control
Control

スクリプトを登録するコントロール。

type
Type

クライアント スクリプトの型。 このパラメーターは、通常、typeof 演算子 (C#) または GetType 演算子 (Visual Basic) を使用して指定され、スクリプトを登録するコントロールの型を取得します。

resourceName
String

リソースの識別子。

例外

ArgumentNullException

クライアント リソースの type が null です。

  • または - スクリプトを登録するコントロールが null です。
ArgumentException

スクリプトを登録するコントロールがページのコントロール ツリー内にありません。

注釈

このメソッドを RegisterClientScriptResource 使用して、部分ページ レンダリングと互換性があり、Microsoft Ajax ライブラリの依存関係がないスクリプトを登録します。 このメソッドを使用して登録されたスクリプト リソースは、更新されたコントロール内UpdatePanelにあるコントロールを表す場合controlにのみ登録されます。 非同期ポストバックが発生するたびにスクリプトを登録するには、このメソッドのオーバーロードを RegisterStartupScript(Page, Type, String, String, Boolean) 使用します。

部分ページ更新に関連しないスクリプト ブロックを登録し、初期ページレンダリング中にスクリプト ブロックを 1 回だけ登録する場合は、クラスのメソッドをRegisterClientScriptBlockClientScriptManager使用します。 ページのプロパティからオブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。

このメソッドは RegisterClientScriptResource 、アセンブリからのリソースが HTTP ハンドラーを介してアクセスされるときに使用されます。 このメソッドには、要素内のリソース URL の内容が script 含まれます。

メソッドとメソッドの RegisterClientScriptInclude 両方が RegisterClientScriptResource 、スクリプト ファイルをブラウザーに読み込みます。 同じ型とキーを持つスクリプト (スクリプト ファイルの場合) または同じ型とリソース名 (埋め込みリソースの場合) が既に読み込まれている場合、スクリプトは再読み込みされません。

こちらもご覧ください

適用対象