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) 此方法的重载。
如果要注册与分页更新无关的ClientScriptManager启动脚本,并且如果要在初始页面呈现期间只注册一次脚本,请使用RegisterStartupScript类的方法。 可以从页面的属性获取对对象的ClientScript引用ClientScriptManager。
方法呈现 RegisterStartupScript 的脚本块在页面完成加载时执行,但在引发页面客户端 onload
事件之前执行。 启动脚本块位于标记前 </form>
呈现的 ASP.NET 页底部。
使用注册的 RegisterStartupScript 启动脚本块不一定按注册顺序输出。 如果启动脚本块的顺序很重要,请使用对象 StringBuilder 在单个字符串中收集脚本块,然后将其全部注册为单个启动脚本。
另请参阅
适用于
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。