Documentation for: ASP.NET Ajax Version 1.0

This documentation is for a previous version. For the current released version, see the ASP.NET Ajax documentation on MSDN.

 

 

 

 

 

 

 

Skip Navigation Links.
ScriptManager Class
ScriptManager Constructor
AllowCustomErrorsRedirect Property
AsyncPostBackError Event
AsyncPostBackErrorMessage Property
AsyncPostBackSourceElementID Property
AsyncPostBackTimeout Property
AuthenticationService Property
EnablePageMethods Property
EnablePartialRendering Property
EnableScriptGlobalization Property
EnableScriptLocalization Property
GetCurrent Method (page)
IsDebuggingEnabled Property
IsInAsyncPostBack Property
LoadPostData Method (postDataKey, postCollection)
LoadScriptsBeforeUI Property
OnAsyncPostBackError Method (e)
OnInit Method (e)
OnPreRender Method (e)
OnResolveScriptReference Method (e)
ProfileService Property
RaisePostDataChangedEvent Method
RegisterArrayDeclaration Method
RegisterArrayDeclaration Method (control, arrayName, arrayValue)
RegisterArrayDeclaration Method (page, arrayName, arrayValue)
RegisterAsyncPostBackControl Method (control)
RegisterClientScriptBlock Method
RegisterClientScriptBlock Method (control, type, key, script, addScriptTags)
RegisterClientScriptBlock Method (page, type, key, script, addScriptTags)
RegisterClientScriptInclude Method
RegisterClientScriptInclude Method (control, type, key, url)
RegisterClientScriptInclude Method (page, type, key, url)
RegisterClientScriptResource Method
RegisterClientScriptResource Method (control, type, resourceName)
RegisterClientScriptResource Method (page, type, resourceName)
RegisterDataItem Method
RegisterDataItem Method (control, dataItem)
RegisterDataItem Method (control, dataItem, isJsonSerialized)
RegisterDispose Method (control, disposeScript)
RegisterExpandoAttribute Method (control, controlId, attributeName, attributeValue, encode)
RegisterExtenderControl Method (extenderControl, targetControl)
RegisterHiddenField Method
RegisterHiddenField Method (control, hiddenFieldName, hiddenFieldInitialValue)
RegisterHiddenField Method (page, hiddenFieldName, hiddenFieldInitialValue)
RegisterOnSubmitStatement Method
RegisterOnSubmitStatement Method (control, type, key, script)
RegisterOnSubmitStatement Method (page, type, key, script)
RegisterPostBackControl Method (control)
RegisterScriptControl Method (scriptControl)
RegisterScriptDescriptors Method
RegisterScriptDescriptors Method (extenderControl)
RegisterScriptDescriptors Method (scriptControl)
RegisterStartupScript Method
RegisterStartupScript Method (control, type, key, script, addScriptTags)
RegisterStartupScript Method (page, type, key, script, addScriptTags)
Render Method (writer)
ResolveScriptReference Event
ScriptMode Property
ScriptPath Property
Scripts Property
Services Property
SetFocus Method
SetFocus Method (clientID)
SetFocus Method (control)
SupportsPartialRendering Property
Visible Property

RegisterArrayDeclaration Method (control, arrayName, arrayValue)

Registers an ECMAScript (JavaScript) array declaration for a control inside an UpdatePanel control with the ScriptManager control, and adds the array to the page by using an array name and array value.

Syntax

CSharp

public static void RegisterArrayDeclaration (
	Control control,
	string arrayName,
	string arrayValue
)

VisualBasic

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

ManagedCPlusPlus

public:
static void RegisterArrayDeclaration (
	Control^ control, 
	String^ arrayName, 
	String^ arrayValue
)

JSharp

public static void RegisterArrayDeclaration (
	Control control,
	String arrayName,
	String arrayValue
)

Parameters

control (Control)

The control that is registering the array.

arrayName (String)

The name of the array to register.

arrayValue (String)

The array value or values to register.

Remarks

The RegisterArrayDeclaration method is used to a 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 when the control parameter is inside an UpdatePanel control that is updated. To register an array each time an asynchronous postback occurs, use the RegisterArrayDeclaration(Page, String, String) overload of this method. If you are registering a script array that does not pertain to partial-page updates and you want to register an array only one time during initial page rendering, use the RegisterArrayDeclaration(String, String) method of the ClientScriptManager class. You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

The RegisterArrayDeclaration method determines whether an array with the name specified in the arrayName parameter is already registered. If so, the method adds the values specified in arrayValue. Because the array to be registered is based on the ArrayList class, duplicates are allowed. If a registered array with the name in arrayName does not exist, the array is created and the values in arrayValue are added to it.

To include string literals in the array, use single quotation marks (') or escaped double quotation marks (\") in arrayValue.

Note that JavaScript treats a comma (,) as a delimiter in an array. Separating two items with a comma in arrayValue is equivalent to calling the RegisterArrayDeclaration method twice, once for each item.

Exceptions

ExceptionCondition
ArgumentNullException

arrayName is null.

Assembly: System.Web.Extensions (Module: System.Web.Extensions)