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.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
public: static void RegisterArrayDeclaration( Page^ page, String^ arrayName, String^ arrayValue )
Parameters
- page
-
Type:
System.Web.UI::Page^
The page object that is registering the array.
- arrayName
-
Type:
System::String^
The name of the array to register.
- arrayValue
-
Type:
System::String^
The array value or values to register.
| Exception | Condition |
|---|---|
| ArgumentNullException | 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.
Available since 3.5