RegisterArrayDeclaration Method (Page, String, String)
Collapse the table of content
Expand the table of content

ScriptManager.RegisterArrayDeclaration Method (Page, String, String)

Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

Namespace:  System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public static void RegisterArrayDeclaration(
	Page page,
	string arrayName,
	string arrayValue


Type: System.Web.UI.Page
The page object that is registering the array.
Type: System.String
The name of the array to register.
Type: System.String
The array value or values to register.


arrayName is null.

You use the RegisterArrayDeclaration method to register a client script array that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. This method registers the array every time that an asynchronous postback occurs. To register an array for a control that is inside an UpdatePanel control so that the array is registered only when the panel is updated, use the RegisterArrayDeclaration(Control, String, String) overload of this method. 

If you want to register an array that does not pertain to partial-page updates, and if you want to register the array only one time during initial page rendering, use the RegisterArrayDeclaration method of the ClientScriptManager class. You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

.NET Framework

Supported in: 4, 3.5

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

© 2016 Microsoft