ScriptManager.RegisterStartupScript メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
起動スクリプト ブロックを ScriptManager コントロールに登録し、スクリプト ブロックをページに追加します。
オーバーロード
RegisterStartupScript(Control, Type, String, String, Boolean) |
ScriptManager コントロールを使用して UpdatePanel 内のコントロールの起動スクリプト ブロックを登録し、スクリプト ブロックをページに追加します。 |
RegisterStartupScript(Page, Type, String, String, Boolean) |
非同期ポストバックのたびに起動スクリプト ブロックを ScriptManager コントロールに登録し、スクリプト ブロックをページに追加します。 |
RegisterStartupScript(Control, Type, String, String, Boolean)
ScriptManager コントロールを使用して UpdatePanel 内のコントロールの起動スクリプト ブロックを登録し、スクリプト ブロックをページに追加します。
public:
static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript (System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)
パラメーター
- control
- Control
クライアント スクリプト ブロックを登録するコントロール。
- type
- Type
クライアント スクリプト ブロックの型。 このパラメーターは、通常、typeof 演算子 (C#) または GetType 演算子 (Visual Basic) を使用して指定され、スクリプトを登録するコントロールの型を取得します。
- key
- String
スクリプト ブロックの一意の識別子。
- script
- String
登録するスクリプト。
- addScriptTags
- Boolean
スクリプト ブロックを <script>
タグと </script>
タグで囲む場合は true
。それ以外の場合は false
。
例外
control
がページのコントロール ツリーにありません。
注釈
メソッドをRegisterStartupScript使用して、部分ページ レンダリングと互換性があり、Microsoft Ajax ライブラリの依存関係がないページのスタートアップ スクリプト ブロックを登録します。 このメソッドを使用して登録されたスタートアップ スクリプト ブロックは、ブロックを登録しているコントロールが更新中のコントロール内 UpdatePanel にある場合にのみページに送信されます。 非同期ポストバックが発生するたびにスタートアップ スクリプト ブロックを登録するには、このメソッドのオーバーロードを RegisterStartupScript(Page, Type, String, String, Boolean) 使用します。
部分ページ更新に関連しないスタートアップ スクリプトを登録する場合、および初期ページレンダリング中にスクリプトを 1 回だけ登録する場合は、 クラスの メソッドをRegisterStartupScriptClientScriptManager使用します。 ページの プロパティから オブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。
メソッドによって RegisterStartupScript レンダリングされるスクリプト ブロックは、ページの読み込みが完了したときに、ページのクライアント onload
イベントが発生する前に実行されます。 スタートアップ スクリプト ブロックは、タグの直前にあるレンダリングされた ASP.NET ページの </form>
下部にあります。
を使用 RegisterStartupScript して登録されたスタートアップ スクリプト ブロックは、それらが登録されているのと同じ順序で出力されるとは限りません。 スタートアップ スクリプト ブロックの順序が重要な場合は、 オブジェクトを StringBuilder 使用してスクリプト ブロックを 1 つの文字列で収集し、それらすべてを 1 つのスタートアップ スクリプトとして登録します。
こちらもご覧ください
適用対象
RegisterStartupScript(Page, Type, String, String, Boolean)
非同期ポストバックのたびに起動スクリプト ブロックを ScriptManager コントロールに登録し、スクリプト ブロックをページに追加します。
public:
static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript (System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)
パラメーター
- page
- Page
クライアント スクリプト ブロックを登録するページ オブジェクト。
- type
- Type
クライアント スクリプト ブロックの型。 このパラメーターは、通常、typeof 演算子 (C#) または GetType 演算子 (Visual Basic) を使用して指定され、スクリプトを登録するコントロールの型を取得します。
- key
- String
スクリプト ブロックの一意の識別子。
- script
- String
登録するスクリプト。
- addScriptTags
- Boolean
スクリプト ブロックを <script>
タグと </script>
タグで囲む場合は true
。それ以外の場合は false
。
注釈
非同期ポストバックが発生するたびに含まれるスタートアップ スクリプト ブロックを登録するには、このメソッドを使用します。 コントロール内 UpdatePanel にあるコントロールのスクリプト ブロックを登録し、コントロールが更新されたときにのみ UpdatePanel スクリプト ブロックが登録されるようにするには、このメソッドのオーバーロードを RegisterStartupScript(Control, Type, String, String, Boolean) 使用します。
部分ページ更新に関連しないスタートアップ スクリプトを登録する場合、および初期ページレンダリング中にスクリプトを 1 回だけ登録する場合は、 クラスの メソッドをRegisterStartupScriptClientScriptManager使用します。 ページの プロパティから オブジェクトへの ClientScriptManager 参照を ClientScript 取得できます。
こちらもご覧ください
適用対象
.NET