ScriptManager::RegisterArrayDeclaration Method (Page^, String^, String^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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
)

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.

.NET Framework
Available since 3.5
Return to top
Show: