ScriptManager.RegisterStartupScript 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.Extensions.dll

向 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。

例外

ArgumentNullException

control 为 null。

• 或 - type 为 null。

ArgumentException

control 不在该页面的控件树中。

注解

可以使用此方法 RegisterStartupScript 为与分页呈现兼容的页面注册启动脚本块，并且该页面没有 Microsoft Ajax 库依赖项。 仅当注册块的控件位于正在更新的控件内 UpdatePanel 时，才使用此方法注册的启动脚本块发送到页面。 若要每次发生异步回发时注册启动脚本块，请使用 RegisterStartupScript(Page, Type, String, String, Boolean) 此方法的重载。

如果要注册与分页更新无关的ClientScriptManager启动脚本，并且如果要在初始页面呈现期间只注册一次脚本，请使用RegisterStartupScript类的方法。 可以从页面的属性获取对对象的ClientScript引用ClientScriptManager。

方法呈现 RegisterStartupScript 的脚本块在页面完成加载时执行，但在引发页面客户端 onload 事件之前执行。 启动脚本块位于标记前 </form> 呈现的 ASP.NET 页底部。

使用注册的 RegisterStartupScript 启动脚本块不一定按注册顺序输出。 如果启动脚本块的顺序很重要，请使用对象 StringBuilder 在单个字符串中收集脚本块，然后将其全部注册为单个启动脚本。

另请参阅

• RegisterStartupScript(Page, Type, String, String, Boolean)

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) 此方法的重载。

如果要注册与分页更新无关的ClientScriptManager启动脚本，并且如果要在初始页面呈现期间只注册一次脚本，请使用RegisterStartupScript类的方法。 可以从页面的属性获取对对象的ClientScript引用ClientScriptManager。

另请参阅

• RegisterStartupScript(Control, Type, String, String, Boolean)