ScriptManager.RegisterArrayDeclaration 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.Extensions.dll

向 ScriptManager 控件注册一个 ECMAScript (JavaScript) 数组声明以与 UpdatePanel 控件内的某个控件一起使用，并将此数组添加到页面中。

重载

RegisterArrayDeclaration(Control, String, String)	向 ScriptManager 控件注册一个 ECMAScript (JavaScript) 数组声明以与 UpdatePanel 控件内的某个控件一起使用，并将此数组添加到页面中。
RegisterArrayDeclaration(Page, String, String)	向 ScriptManager 控件注册一个 ECMAScript (JavaScript) 数组声明以与 UpdatePanel 控件内的某个控件一起使用，并将此数组添加到页面中。

RegisterArrayDeclaration(Control, String, String)

向 ScriptManager 控件注册一个 ECMAScript (JavaScript) 数组声明以与 UpdatePanel 控件内的某个控件一起使用，并将此数组添加到页面中。

public:
 static void RegisterArrayDeclaration(System::Web::UI::Control ^ control, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration (System.Web.UI.Control control, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Control * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (control As Control, arrayName As String, arrayValue As String)

参数

control

Control

正在注册数组的控件。

arrayName

String

要注册的数组的名称。

arrayValue

String

要注册的一个或多个数组值。

例外

ArgumentNullException

arrayName 为 null。

注解

使用 RegisterArrayDeclaration 此方法注册与分页呈现兼容的客户端脚本数组，并且没有 Microsoft Ajax 库依赖项。 当表示正在更新的控件内的UpdatePanel控件时control，此方法将注册数组。 若要每次发生异步回发时注册数组，请使用 RegisterArrayDeclaration(Page, String, String) 此方法的重载。

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

该方法 RegisterArrayDeclaration 确定参数中指定的 arrayName 名称的数组是否已注册。 If so, the method adds the values specified in arrayValue. 由于要注册的数组基于 ArrayList 类，因此允许重复项。 如果不存在具有名称 arrayName 的已注册数组，则会创建该数组，并将其中 arrayValue 的值添加到该数组中。

若要在数组中包含字符串文本，请使用单引号 (') 或转义双引号 (\“) 。arrayValue

请注意，JavaScript 将逗号 (，) 视为数组中的分隔符。 可以通过传入 arrayValue逗号分隔的字符串来指定多个数组值。 用逗号 arrayValue 分隔两个项相当于调用 RegisterArrayDeclaration 方法两次，每个项一次。

另请参阅

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

向 ScriptManager 控件注册一个 ECMAScript (JavaScript) 数组声明以与 UpdatePanel 控件内的某个控件一起使用，并将此数组添加到页面中。

public:
 static void RegisterArrayDeclaration(System::Web::UI::Page ^ page, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration (System.Web.UI.Page page, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Page * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (page As Page, arrayName As String, arrayValue As String)

参数

page

Page

正在注册该数组的页对象。

arrayName

String

要注册的数组的名称。

arrayValue

String

要注册的一个或多个数组值。

例外

ArgumentNullException

arrayName 为 null。

注解

使用 RegisterArrayDeclaration 此方法注册与分页呈现兼容的客户端脚本数组，并且没有 Microsoft Ajax 库依赖项。 此方法每次发生异步回发时注册数组。 若要为控件内的 UpdatePanel 控件注册数组，以便仅在更新面板时注册该数组，请使用 RegisterArrayDeclaration(Control, String, String) 此方法的重载。

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

另请参阅

• RegisterArrayDeclaration(Control, String, String)