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

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

另请参阅

适用于

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

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

RegisterClientScriptResource当通过 HTTP 处理程序访问来自程序集的资源时，将使用此方法。 此方法包括元素中 script 资源 URL 的内容。

方法RegisterClientScriptIncludeRegisterClientScriptResource将脚本文件加载到浏览器中。 如果脚本文件) 具有相同类型和键 (的脚本或已加载嵌入资源) 的相同类型和资源名称 (，则不会重新加载该脚本。

另请参阅

适用于