ScriptManager.RegisterClientScriptResource メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを 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
リソースの識別子。
例外
注釈
このメソッドでスクリプト ファイルを登録すると、非同期ポストバックが発生するたびにスクリプトがレンダリングされます。 コントロール内にあるコントロールのスクリプトを 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
リソースの識別子。
例外
スクリプトを登録するコントロールがページのコントロール ツリー内にありません。
注釈
このメソッドを RegisterClientScriptResource 使用して、部分ページ レンダリングと互換性があり、Microsoft Ajax ライブラリの依存関係がないスクリプトを登録します。 このメソッドを使用して登録されたスクリプト リソースは、更新されたコントロール内UpdatePanelにあるコントロールを表す場合control
にのみ登録されます。 非同期ポストバックが発生するたびにスクリプトを登録するには、このメソッドのオーバーロードを RegisterStartupScript(Page, Type, String, String, Boolean) 使用します。
部分ページ更新に関連しないスクリプト ブロックを登録し、初期ページレンダリング中にスクリプト ブロックを 1 回だけ登録する場合は、クラスのメソッドをRegisterClientScriptBlockClientScriptManager使用します。 ページのプロパティからオブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。
このメソッドは RegisterClientScriptResource 、アセンブリからのリソースが HTTP ハンドラーを介してアクセスされるときに使用されます。 このメソッドには、要素内のリソース URL の内容が script
含まれます。
メソッドとメソッドの RegisterClientScriptInclude 両方が RegisterClientScriptResource 、スクリプト ファイルをブラウザーに読み込みます。 同じ型とキーを持つスクリプト (スクリプト ファイルの場合) または同じ型とリソース名 (埋め込みリソースの場合) が既に読み込まれている場合、スクリプトは再読み込みされません。